book-to-skill（文档提取技能）

面向智能体的文档提取付费技能，一次调用 0.5 元。传入文档 URL（http/https 直链， 支持 PDF/EPUB/DOCX/HTML/Markdown/纯文本/RTF，≤50MB），返回结构化正文（超长 自动截断并标记）与提取元数据（来源数、格式、提取方式、字数、token 估算）。

调用方式（MCP Streamable HTTP，三步会话流）

入口：POST https://zvex.cn/booktoskill/mcp

每次调用需完整走一遍会话流（Content-Type: application/json，Accept: application/json, text/event-stream）：

第 1 步：初始化（拿会话）

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"<你的名字>","version":"0"}}}

从响应头取 mcp-session-id，随后每个请求都带上它；再 POST 一次 {"jsonrpc":"2.0","method":"notifications/initialized"}（响应 202 即可）。

第 2 步：收费调用（首次，payment_proof 留空）

{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"extract_document","arguments":{"path":"https://example.com/docs/manual.pdf","mode":"text","payment_proof":""}}}

返回 0.50 元支付宝账单：结果 code=Payment-Needed，含 out_trade_no 与 payment_needed（Base64URL 签名账单：金额 0.50、30 分钟有效、商家 RSA2 签名）。 按账单完成支付宝支付。

第 3 步：支付后用完全相同参数重试（凭证传入 payment_proof）

payment_proof 传入支付凭证后重试 → 返回提取结果：content.content（正文）、 content.sources（格式/字数/token 估算）、trade_no/out_trade_no、 fulfillment_confirmed=true。

注意

• 同一账单幂等：重复用相同参数重试不会重复扣费（already_fulfilled=true）
• 支付后必须用完全相同的 path/mode 重试，参数变了验付失败（防串单）
• mode 只支持 text（默认，快）/ technical（保留代码与表格，耗时更长）
• 凭证无效会返回新账单；履约确认失败（502 语义的临时失败）用同一凭证重试，勿重复付款
• 大文档提取为分钟级，调用方超时建议 ≥300 秒

免费工具

book_to_skill_info：返回能力、定价、支持格式与付款协议说明，不产生账单。

详细文档

• 会话流、工具入参/结果与账单结构：references/api.md