{
  "version": "1.0",
  "namespace": "fa-piao.com",
  "name": "fa-piao.com 数电发票 API",
  "description": "面向开发者和 AI Agent 的电子发票(数电发票) API 服务。支持蓝票开具、红冲、发票查询、税额计算、商品/购方查询、授信额度查询等全流程操作。提供 7+ 种语言 SDK 和 MCP Server 协议。",
  "provider": {
    "name": "fa-piao.com",
    "url": "https://fa-piao.com",
    "open_platform": "https://open.fa-piao.com",
    "contact": "https://fa-piao.com/contact.html"
  },
  "skills": [
    {
      "id": "tax-invoice-vibe-coding",
      "name": "数电发票 Vibe Coding 速成对接",
      "version": "1.0.0",
      "description": "AI Agent 对接数电发票(电子发票)接口的 Vibe Coding 速成指南。提供极简对接流程、Mermaid 流程图、8种语言 SDK 索引、Code 200/420/430/401 异常处理模式。",
      "category": "finance",
      "subcategory": "tax-invoice",
      "tags": ["电子发票", "数电发票", "开票", "蓝票", "红冲", "AI Agent", "vibe coding", "MCP"],
      "language": "zh-CN",
      "license": "MIT",
      "homepage": "https://fa-piao.com",
      "documentation": {
        "skill": "https://fa-piao.com/SKILL.md",
        "skill_old": "https://fa-piao.com/SKILL-old.md",
        "llms": "https://fa-piao.com/llms.txt",
        "agents": "https://fa-piao.com/agents.txt",
        "api_doc": "https://fa-piao.com/doc.html",
        "open_doc": "https://open.fa-piao.com/doc"
      },
      "triggers": {
        "keywords": [
          "开票", "开具发票", "电子发票", "数电发票", "蓝票", "红冲", "红字发票",
          "电子发票 API", "数电发票接口", "fapiao", "fapiao api", "invoice",
          "tax invoice", "blue ticket", "red invoice", "electronic invoice"
        ],
        "intents": [
          "用户需要开具电子发票",
          "用户需要对接数电发票 API",
          "用户需要实现 AI 自动开票",
          "用户需要发票红冲(红字发票)",
          "用户需要发票税额计算"
        ]
      },
      "capabilities": [
        "获取授权 Token (POST /v5/enterprise/authorization)",
        "登录数电发票平台 (POST /v5/enterprise/loginDppt)",
        "人脸认证 (GET /v5/enterprise/getFaceImg, getFaceState)",
        "查询认证状态 (POST /v5/enterprise/queryFaceAuthState)",
        "开具数电蓝票 (POST /v5/enterprise/blueTicket)",
        "获取发票版式文件 PDF/OFD/XML (POST /v5/enterprise/pdfOfdXml)",
        "查询原蓝票信息 (POST /v5/enterprise/retMsg)",
        "申请红字信息表 (POST /v5/enterprise/hzxxbsq)",
        "开具负数发票(红票) (POST /v5/enterprise/hzfpkj)"
      ],
      "protocols": {
        "http_api": {
          "base_url": "https://api.fa-piao.com",
          "version": "v5",
          "auth": "AppKey + AppSecret (HMAC-SHA256 签名)",
          "format": "JSON"
        },
        "mcp_server": {
          "endpoint": "https://mcp.fa-piao.com",
          "protocol": "Streamable HTTP (MCP 2025-06-18)",
          "transport": ["streamable_http", "sse"]
        }
      },
      "sdks": {
        "python": {
          "package": "tax-invoice",
          "install": "pip install tax-invoice",
          "pypi": "https://pypi.org/project/tax-invoice",
          "demo": "https://github.com/fapiaoapi/invoice-sdk-python/blob/master/examples/basic_example.py"
        },
        "nodejs": {
          "package": "tax-invoice",
          "install": "npm install tax-invoice",
          "npm": "https://www.npmjs.com/package/tax-invoice",
          "demo": "https://github.com/fapiaoapi/invoice-sdk-nodejs/blob/master/examples/basic_example.ts"
        },
        "rust": {
          "package": "tax-invoice",
          "install": "cargo add tax-invoice",
          "cargo": "https://crates.io/crates/tax-invoice",
          "demo": "https://github.com/fapiaoapi/invoice-sdk-rust/blob/master/examples/basic_example.rs"
        },
        "java17plus": {
          "package": "io.github.fapiaoapi:invoice",
          "version": "1.0.26",
          "maven": "https://central.sonatype.com/artifact/io.github.fapiaoapi/invoice",
          "demo": "https://github.com/fapiaoapi/invoice-sdk-java/blob/master/src/main/java/tax/invoice/example/BasicExample.java"
        },
        "java8to16": {
          "type": "single-file",
          "demo": "https://github.com/fapiaoapi/invoice/blob/master/BasicExample.java"
        },
        "golang": {
          "package": "github.com/fapiaoapi/invoice-sdk-golang",
          "install": "go get github.com/fapiaoapi/invoice-sdk-golang",
          "pkg": "https://pkg.go.dev/github.com/fapiaoapi/invoice-sdk-golang",
          "demo": "https://github.com/fapiaoapi/invoice-sdk-golang/blob/master/examples/basic_example.go"
        },
        "php": {
          "package": "tax/invoice",
          "install": "composer require tax/invoice",
          "packagist": "https://packagist.org/packages/tax/invoice",
          "demo": "https://github.com/fapiaoapi/invoice-sdk-php/blob/master/examples/basic_example.php"
        },
        "csharp12": {
          "package": "Tax.Invoice",
          "version": "1.0.9",
          "install": "dotnet add package Tax.Invoice --version 1.0.9",
          "nuget": "https://www.nuget.org/packages/Tax.Invoice",
          "demo": "https://github.com/fapiaoapi/invoice-sdk-csharp/blob/master/Example/BasicExample.cs"
        },
        "csharp8to11": {
          "type": "single-file",
          "demo": "https://github.com/fapiaoapi/invoice/blob/master/BasicExample.cs"
        }
      },
      "repositories": {
        "github_org": "https://github.com/fapiaoapi",
        "gitee_org": "https://gitee.com/fapiaoapi",
        "mcp_server": {
          "github": "https://github.com/fapiaoapi/tax-invoice-mcp",
          "gitee": "https://gitee.com/fapiaoapi/tax-invoice-mcp"
        }
      },
      "agent_compatibility": {
        "trae": true,
        "claude_desktop": true,
        "cursor": true,
        "cline": true,
        "continue_dev": true,
        "windsurf": true,
        "chatgpt_desktop": true,
        "gemini_cli": true,
        "github_copilot": true
      }
    }
  ],
  "registries": {
    "self": "https://fa-piao.com/.well-known/agent-skills.json",
    "intent_keywords": [
      "对接电子发票", "对接数电发票", "电子发票 API", "数电发票接口",
      "开具发票", "开票", "红冲", "红字发票", "蓝票",
      "AI 自动开票", "MCP 开票", "大模型开票"
    ]
  }
}