关于 Agent Data Tools: Web, documents and search
Agent Data Tools: Web, documents and search 是面向在线内容处理的 Agent 按次付费 MCP 与 HTTP 服务。其 web 分类提供网页和 PDF 提取、JavaScript 渲染页面读取、订阅源、站点地图及搜索工具,并提供 25 次免费成功调用。
主要功能
- 01提取网页和 PDF 文本
- 02读取 JavaScript 渲染页面
- 03访问订阅源和站点地图
- 04搜索网页与新闻
- 05支持 MCP 和普通 HTTP
适用场景
- 01提取网页或 PDF 中的文本
- 02读取 JavaScript 页面内容
- 03从站点地图查找 URL
- 04搜索网页或新闻
MCP 相关
可通过 Streamable HTTP 服务端点或 web 分类端点连接 MCP 客户端。调用自动使用免费额度,付费调用可使用支持的支付方式。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://agent-data-tools.revmesh2074.workers.dev/mcp/webclaude mcp add --transport http nutshell2000-agent-data-tools-web https://agent-data-tools.revmesh2074.workers.dev/mcp/web{"mcpServers":{"nutshell2000-agent-data-tools-web":{"type":"http","url":"https://agent-data-tools.revmesh2074.workers.dev/mcp/web"}}}在 Cursor 中打开{"servers":{"nutshell2000-agent-data-tools-web":{"type":"http","url":"https://agent-data-tools.revmesh2074.workers.dev/mcp/web"}}}在 VS Code 中打开{"mcpServers":{"nutshell2000-agent-data-tools-web":{"type":"http","url":"https://agent-data-tools.revmesh2074.workers.dev/mcp/web"}}}{"mcpServers":{"nutshell2000-agent-data-tools-web":{"serverUrl":"https://agent-data-tools.revmesh2074.workers.dev/mcp/web"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://agent-data-tools.revmesh2074.workers.dev/mcp/web需要授权工具
详细介绍
Agent 数据工具
通过 MCP 和普通 HTTP 为 AI Agent 提供 187 种按调用付费的工具:网络搜索和新闻、收款方筛查和 OFAC 制裁检查、加密代币价格、钱包余额和代币转账、网页转 Markdown、PDF 转文本、电子邮件验证、公司和域名查询、天气、SEC 文件、世界银行 GDP、通胀、人口和失业率、大模型聊天和嵌入。完整功能包括:在 5 条 EVM 链及 Bitcoin 上读取区块链数据、代币价格和风险、OFAC 制裁和交易对手检查、公司和域名数据、网页和 PDF 转文本、天气、时间、国家,以及日常实用工具(JSON、CSV、哈希、日期、校验器)。大多数工具每次成功调用收费 $0.01。
快速开始
- **连接:**将任意 MCP 客户端连接到
https://agent-data-tools.revmesh2074.workers.dev/mcp(Streamable HTTP,无需注册),或使用上方按钮。Claude Code:claude mcp add --transport http agent-data-tools https://agent-data-tools.revmesh2074.workers.dev/mcp。Claude.ai 和 ChatGPT:使用https://agent-data-tools.revmesh2074.workers.dev/mcp/account添加自定义连接器。如果客户端限制加载的工具数量,请改为连接单个分区。较小的分区:/mcp/prices、/mcp/chain、/mcp/web、/mcp/compliance、/mcp/ai、/mcp/everyday、/mcp/utilities。 - **免费试用:**每位调用者均可免费成功调用 25 次;通过 MCP 调用时会自动使用免费次数。通过 HTTP 调用时添加
trial=1。失败的调用永不计入次数。AI、渲染和搜索工具不包含在内。 - 之后可任选一种方式付费:
- **银行卡:**在 /credits 购买预付额度($5 = 5,000 点,$20 = 22,000 点,$100 = 125,000 点;1 点 = $0.001),并在 HTTP 调用中或 MCP 客户端的连接标头中通过
Authorization: Bearer adt_…(或X-API-Key)发送密钥。 - **加密货币:**任何 x402 客户端都可通过 Base、Polygon、Arbitrum 或 Solana 上的 USDC 按次付费;MPP 客户端可通过 Tempo 或 Base 付费。
- **银行卡:**在 /credits 购买预付额度($5 = 5,000 点,$20 = 22,000 点,$100 = 125,000 点;1 点 = $0.001),并在 HTTP 调用中或 MCP 客户端的连接标头中通过
失败的调用永不收费。为每种工具提供免费输出预览:添加 sample=1。机器可读目录:/openapi.json、/llms.txt。支持邮箱:[email protected]。
详情和买家客户端
由 SpellzCode 运营。通过一个有调用上限、无需账户的客户端检查 Base 交易或钱包:一条交易状态结果收费 $0.003,一份钱包快照收费 $0.005。在明确授权购买前,可先查看免费报价。可选的 Gas 和额度检查每项收费 $0.002;客户端绝不会自动购买这些检查。使用已有资金的 Base x402 钱包,且绝不会发送正在检查的交易。
对于静态文档阅读,只需 $0.002 USDC(Base),即可获取清晰的文本、Markdown、代码和表格。无需账户或订阅。仅支持静态 HTML、Markdown 和纯文本;不支持 JavaScript 渲染、需身份验证的页面或付费墙访问。
- 浏览全部 187 种工具及价格
- 链上客户端:下载、验证、报价并购买一项结果
- 查看真实结果 → 查看免费报价 → 购买一个页面
- 无需编写客户端即可使用本地 MCP 适配器
- 查看可移植的购买者技能和安装上下文
- 从三个页面研究一个技术问题:最高 $0.006
- 从站点地图发现文档 URL:$0.002
- 真实缓存示例和自有来源 HTML
- 提取基准测试和限制
- 次要功能:通过设有上限的 CLI 和本地 MCP 命令获取 Bitcoin 费用数据
阅读器客户端需要 Node 20.19+,无需安装 npm 或使用 TypeScript。未签名的报价无需密钥,也不会产生付款。明确授权的阅读器购买需要已有资金的 Base 钱包,且单次调用上限不超过 $0.002。本地 MCP 适配器以仅报价模式启动;有意启用购买后,阅读器、站点地图和 Bitcoin 数据调用会共享进程预算。密钥保留在购买者的设备上。独立的链上客户端有上述各项操作的专属上限,不会授予会话或月度消费额度。
仓库提供的 1.7.6 备用下载:CLI 可执行文件及其校验和,或本地 MCP 适配器及其校验和。将可执行文件和对应的校验和保存到同一文件夹,然后按照验证说明操作,再运行文件。发行说明和全部六个文件。这些文件与网站发布的字节完全一致;校验和不是独立的安全签名。较早的 1.7.0 下载和 1.5.1 下载仍可按原样获取。
已有尝试需要帮助?请使用请求 ID、大致的 UTC 时间以及报告的付款状态报告购买问题。如果已签名的操作结果不确定,请停止操作;不要为了重现问题而再次购买。如果缺少文本、代码或表格,请提供简短的公开示例或自撰示例报告输出问题。报告内容公开:切勿包含密钥、签名、原始付款标头或私人内容。
阅读器还支持精确的 HTML 区块 ID,并会保留带标签的来源图像描述;但不会解读图像像素。现在,来源声明的作者以及发布日期/更新日期会在可用时附带来源信息和未验证/歧义警告。在声称覆盖范围之前,请先检查范围、输出限制和警告。完整购买说明。
缓存示例是在构建时对自有 HTML 运行所得的真实结果,并与说明性片段分开标注。本地测试无法证明生产环境中有资金支持的交付能力,也无法证明客户需求。
一个 Cloudflare Worker,向 AI Agent 提供 175 个活跃工具。每次调用均通过 x402 协议(Base、Polygon、Arbitrum、Monad 或 World Chain)以 USDC 付款,或使用预付卡额度付款,款项会直接转入 PAY_TO 中的地址。
| Endpoint | 返回内容 | 价格 |
|---|---|---|
GET /sitemap?url=&contains=&maxUrls=&offset= | XML 站点地图 URL、来源报告的日期和分页结果(有限制,不会爬取) | $0.002 |
GET /extract?url= | 网页的纯文本、标题和链接 | $0.002 |
GET /domain?name= | DNS、注册时长、SPF/DMARC | $0.005 |
GET /domain-report?name= | 域名信任判定和电子邮件身份验证标记 | $0.01 |
GET /token?address= | Base ERC-20 信息和风险标记 | $0.01 |
GET /token-report?address= | Base 代币风险和实时 DEX 市场数据 | $0.01 |
GET /wallet?address= | Base 钱包余额和账户 nonce | $0.005 |
GET /summarize?url= | 页面摘要和要点 | $0.01 |
GET /screenshot?url= | 页面渲染后的 JPEG(base64) | $0.01 |
GET /image?prompt= | 生成的 1024x1024 图像(base64) | $0.01 |
GET /transcribe?url= | 音频文件的文本(最大 5 MB) | $0.01 |
GET /describe?url= | 图像描述,或关于图像的回答 | $0.01 |
GET /btc-fees | 比特币手续费率和内存池状态 | $0.002 |
GET /btc-address?address= | 比特币地址余额和活动记录 | $0.01 |
GET /ln-invoice?invoice= | 解码后的 Lightning 发票 | |
GET /package-audit?packages= | 审计最多 10 个依赖项;支持针对确切版本的公告和修复方案 | $0.01 |
GET /wallet-audit?address= | Base 代币持仓和基于 nonce 的启发式风险指标 | $0.01 |
GET /contract-risk?address= | 有限的字节码、EIP-1967 槽位和零供应量启发式指标 | $0.01 |
GET /trade-insight?token=&wallet= | 分别提供代币和钱包风险指标;不提供交易建议 | $0.01 |
GET /liquidity-pool-audit?address= | 已验证的 Base DEX 交易对详情和报告的市场数据 | $0.01 |
GET /mev-simulator | 使用固定典型 gas 单位估算 Base gas 成本;并非报价 | $0.01 |
GET /package?ecosystem=&name=&version= | 最新或指定版本的软件包元数据,以及有限的依赖项风险信号(不保证安全) | |
GET /email?address= | 验证电子邮件地址,不发送邮件 | |
GET /papers?query= | 学术论文搜索 | $0.01 |
GET /fx?from=&to= | 货币汇率和换算 | |
GET /btc-price | 主要货币的比特币价格 | |
GET /base-gas | Base 网络 gas 价格和费用估算 | $0.002 |
GET /base-tx?hash= | Base 交易状态和详情 | $0.003 |
GET /base-allowance?token=&owner=&spender= | Base 上的 ERC-20 授权检查 | $0.002 |
GET /ens?name= | ENS 名称/地址解析 | |
GET /weather?lat=&lon= | 当前天气和逐小时预报 | |
GET /time?zone= | 当前时间和时区转换 |
免费调用已启用:每位调用者可成功调用 25 次,每日总计 2,000 次(src/lib/free-calls.ts);通过 MCP 自动启用,通过 HTTP 使用 trial=1 启用。不带 trial=1 的未付款 HTTP 请求会收到常规的 402 挑战。上表列出了一些核心工具;完整的最新目录位于 /#tools 和 /openapi.json 中。
主页和 llms.txt 包含一段可直接复制粘贴的 Node.js/TypeScript x402 客户端代码,使用 @x402/fetch、@x402/evm 和 viem。它从 X402_PRIVATE_KEY 读取私钥(切勿将其硬编码或提交到代码库),固定使用 Base、服务公布的 PAY_TO 收款地址和 Base USDC,并将每笔付款上限设为 $0.01(普通的单次调用价格),因此可支付价格不超过 $0.01 的所有工具。它不会添加 trial=1。/package-audit 的单次调用价格仍为 $0.20;此低支出示例会有意拒绝调用它。OpenAPI 的 x-guidance 包含相同的客户端、价格和试用说明。各工具专属指南(/guides/web-reading、/guides/bitcoin-fees、/guides/dependency-audit)则固定为对应工具的确切价格。
服务的预发布副本运行在 Base Sepolia 测试网上(wrangler.staging.jsonc、无密钥的 facilitator、faucet USDC),因此每次发布前都可通过 scripts/pay-test.mjs,在 HTTP v2、HTTP v1 和 MCP 上进行真实付款测试,然后再部署到生产环境;请参阅 CLAUDE.md。测试网结算不计为收入。
/package 在省略 version 时仍会查询最新版本。将 ecosystem、name 和可选的确切 version 作为单独输入传入(例如,ecosystem=npm&name=lodash&version=4.17.20),即可返回固定版本的元数据和 deps.dev 安全公告。版本范围和标签会被拒绝。要查询确切版本的 OSV 受影响范围和带日期的 FIRST EPSS CVE 估算值,请使用 /package-audit。
/package-audit 最多接受 10 个以逗号分隔的 ecosystem:name 项,可选带有确切版本,例如 npm:[email protected] 或 npm:@types/[email protected]。未指定版本的项目仍会检查最新版本。为限制出站请求数量,它不会查询 npm 每周下载量;weeklyDownloadsStatus 的值为 not-fetched-subrequest-budget。未指定版本的项目最多会获取一条 deps.dev 安全公告详情,并报告 advisoryDetailsOmitted;详情获取失败会计入 advisoryDetailsUnavailable,并使 advisoryDetailsStatus 标记为部分完成。固定版本的项目会跳过重复的 deps.dev 详情查询,但仍会保留所有安全公告 ID 和数量。确切版本会使用 OSV 批量查询 ID,每次请求最多获取 15 条详细记录;每条安全公告的 detailStatus、detailsNotFetched 和 omittedAdvisories 会标明覆盖范围是否完整。返回的 CVE 别名会通过一次去重请求补充带日期的 FIRST EPSS 估算值(最多 50 个 CVE);epssLookup 会报告来源状态、获取时间、被省略的 CVE 和未检查的 OSV 详情。EPSS 估算的是 30 天内遭利用的概率,并非软件包安全性;缺失的分数表示未知,而非零。ok 或空的安全公告结果都不代表软件包是安全的。
/airdrop-scanner、/liquidity-return-analyzer、/token-holder-analysis、/pair-analyzer 和 /wallet-history 暂不提供,因为本服务没有可验证的实时数据源来支持这些工具所宣称的分析。它们不会列为付费工具,并会返回 HTTP 503,且不发起付款挑战或收费。
AI 端点使用 Workers AI,/screenshot 使用 Browser Rendering。账户额度和实际运营成本必须分别核实;API 价格不代表这些信息。上游容量不足或触发速率限制时会返回错误,且不会结算费用。
免费路由包括自有的 /examples/extract/ 结果、带版本号的 /clients/reader/ 下载、/sitemap.xml、/(浏览器访问时为网页,程序访问时为 JSON)、/openapi.json、/llms.txt、/robots.txt、/health、/.well-known/x402、/.well-known/mcp/server-card.json、/.well-known/api-catalog。
/metrics 按路径报告每日请求数。unsettled 统计付费路径上成功的 HTTP 2xx 响应中,未收到已验证的成功 PAYMENT-RESPONSE 的数量;只有收到有效结算响应的调用才会计入 paid。revenueUsdMicros 是以美元百万分之一为单位的美元总收入,trackedPaidCalls 统计计入该总额的已结算 x402 HTTP API、MCP 工具和 /buy/<slug> 调用。只有当支付封装返回成功的结构化结算结果时,才会记录 MCP 总数;x402 产品购买使用产品目录中的确切价格。收入字段仅记录未来数据,不包含历史回填。结算验证前记录的 paid 数量不能证明已收到付款,不得用于计算收入。挑战、试用、市场请求、未结算响应和直接店面转账金额均不计入。
商店
/store 和 /buy/* 暂停新的数字产品销售(HTTP 503,不发起支付挑战)。现有订单和下载内容仍予保留。保留的实现方式如下:买家会收到确切的 USDC 金额和 PAY_TO 中的地址;订单页面会监控区块链,并在收到匹配的转账后解锁下载。Agent 可以通过常规付费墙在 GET /buy/<slug> 购买相同产品。
- 产品列在
src/store/catalog.ts中。 - 订单和销售日志保存在
TRIALS键值存储中(order:和paid:键)。使用npx wrangler kv key list --binding TRIALS --prefix paid: --remote列出销售记录。 - DeFi Trader Intelligence Bundle 已下架,因为该服务没有 API 密钥身份验证、250 次调用配额或
/account端点。仍支持旧版订单收据,但实际下载交付未经验证。Git 忽略的public/_files/目录下的产品资源有意不纳入 Git;部署全新检出内容前,必须私下配置这些资源。缺少资源会导致付费下载返回 502。现有生产工作树仍保留这些资源。切勿将其发布到源代码管理中。
MCP
全部 179 个目录工具均可通过 /mcp(可流式传输的 HTTP,无状态)作为 MCP 服务使用,也可通过较小的分区服务 /mcp/<section> 使用。列出工具免费。每个调用方都可免费成功调用 25 次;之后,调用将使用卡片额度(连接标头中来自 /credits 的 API 密钥),或返回 x402 付款要求,由支持 x402 的 MCP 客户端完成付款并重试。已登录的 /mcp/account 连接器不会收到加密货币付款请求。失败的工具调用不收费。
每个工具只在 src/endpoints.ts 中定义一次(名称、价格、参数),并只在 src/tools.ts 中实现一次;HTTP 路由、MCP 工具、OpenAPI 文档和网页均由该目录生成。
收录情况
- 官方 MCP Registry:收录名称为
io.github.Nutshell2000/agent-data-tools。要发布新版本,请在server.json中提高version,并推送匹配的v*标签;.github/workflows/publish-mcp.yml中的工作流会在 GitHub 的服务器上完成其余操作。 - 402 Index(https://402index.io):现有读取器条目和目录元数据已于 2026 年 10 月 15 日更新。第三方缓存可能仍未更新;以实时目录和报价为准。
- x402scan:现有收录已覆盖该目录。每次发布后都要核对当前价格;无需重复注册。
- Coinbase Bazaar:Bitcoin 手续费和软件包元数据均已有索引条目。其他路线需要真实结算的付款;仅进行就绪检查不会为其建立索引。
未付款的请求会收到 HTTP 402,并带有 PAYMENT-REQUIRED 标头(x402)和 WWW-Authenticate: Payment 挑战(MPP:使用 Base 上的 USDC 的 evm,以及使用 Tempo 上的 USDC.e 的 tempo;仅在工具成功后结算)。失败的调用(4xx/5xx)不会收费。
兼容 OpenAI:POST /v1/chat/completions、POST /v1/responses 和 POST /v1/embeddings 分别是付费工具 /ai/chat、/ai/chat-large 和 /ai/embed 的前端(价格和付款路径相同);GET /v1/models 免费。将 OpenAI SDK 指向 /v1,并使用 x402 或 MPP fetch 包装器,或者将卡片额度密钥用作其 apiKey。仅支持 GET 的客户端可在查询参数中传入相同输入(/v1/chat/completions?prompt=…、/v1/responses?input=…、/v1/embeddings?input=…)。
当前收入运营
新卖家套件的销售已暂停;现有付费订单仍可下载。免费调用已启用(见上文),且不产生收入。
/metrics 报告请求计数器;/revenue 报告自账本部署以来观察到的、由支付协调方报告并去重后的
结算记录。金额以 Base USDC 原生最小单位的整数表示(6 位小数),已知的自付交易不计入总额。
收据会在现有 Durable Object 中私密保留交易、付款方、授权 nonce、端点和金额证据。
不会存储签名和请求内容。公开响应仅展示汇总总额。即使发生存储错误,也会记录日志,但不会将
已结算客户的响应转变为新的付款请求。
这些总额仍待独立链上核对。不会推算手续费、支出和净收入。历史付费计数无法使用当前价格回填。两笔已编入索引的 历史收据各为 2,000 个最小单位,并与当前 结算账本分开。测试和自付交易绝不算作客户收入。
实时目录是当前工具、价格和试用可用情况的权威信息来源。
配置
所有设置都在 wrangler.jsonc 中:
PAY_TO:接收付款的地址。NETWORK:Base 主网的eip155:8453。FACILITATOR_URL:验证并广播付款的服务。PAYWALL:仅在本地测试时设为off。TRIALS_ENABLED:除非精确设为on,否则试用功能处于禁用状态;设为off(或取消设置)即可禁用试用功能。
命令
npx wrangler dev
使用 npx wrangler deployments list 查看当前 Worker 版本,然后从干净的检出目录部署。该目录应包含最新的 origin/main,且对应的确切提交必须通过 CI:
npm run deploy:production -- --expected-version <live-worker-version-uuid>
添加 --check-only 可在不部署的情况下执行预检。10 月 17 日,一份过时的检出覆盖了购买指南和账本;此保护机制会拒绝过时或有未提交更改的源代码,以及意外的生产基线。但它无法阻止绕过此流程的其他操作员。请协调生产部署,并保留其他检出目录中的并行工作。
npx wrangler tail
wrangler tail 会实时流式传输请求,这是了解是否有人在调用此服务的最快方式。
在 Windows 上,如果项目路径过长,wrangler dev 可能会因 SQLITE_CANTOPEN 失败。添加 --persist-to 并指定较短的文件夹路径即可解决。
如需在不经过付费墙的情况下试用 /screenshot,请使用 npx wrangler dev --remote --var PAYWALL:off。它会在 Cloudflare 上运行,因此不会在这台电脑上下载浏览器。
在 Coinbase Bazaar 中上架
此部署已使用经过身份验证的 Coinbase CDP facilitator。若要单独安装,请配置自己的账户:
-
在 https://portal.cdp.coinbase.com 创建免费 API key。
-
将其保存为 Worker secrets(系统会提示输入每个值):
npx wrangler secret put CDP_API_KEY_IDnpx wrangler secret put CDP_API_KEY_SECRET -
在
wrangler.jsonc中,将FACILITATOR_URL设为https://api.cdp.coinbase.com/platform/v2/x402,然后部署。
Bazaar 会在成功结算一笔带有发现元数据的付款后,为端点建立索引。切勿通过伪造自购来为其创建种子数据。npm run check:live 会针对每个文档化的工具示例运行免费的只读 Coinbase 验证器。它不会签名、结算或创建索引条目。历史脚本 scripts/index-listings.mjs --pay 的路径已禁用。HTTP 和 MCP 的已付款生产交付仍需分别提供证据。
检查是否正常运行
线上 URL:https://agent-data-tools.revmesh2074.workers.dev
Coinbase 提供免费验证器。通过时会显示 "valid":true 和 "simulation":{"outcome":"accepted"}:
curl -X POST https://api.cdp.coinbase.com/platform/v2/x402/validate -H "Content-Type: application/json" -d "{\"resource\":\"https://agent-data-tools.revmesh2074.workers.dev/domain?name=cloudflare.com\",\"method\":\"GET\"}"
收到的付款会显示为转入 https://basescan.org 上 PAY_TO 地址的 USDC 转账。
限制
/extract最多读取页面的 2 MB 内容,并最多等待 8 秒。/token和/wallet使用公共 Base RPC,该服务有速率限制。如果用量增加,请将BASE_RPC_URL设为私有端点。- Token 能力标志是基于字节码的启发式判断;对于代理合约,它们描述的是代理,而不是其实现。
Agent 客户端兼容性证据
2026 年 10 月 15 日,@agentcash/discovery 1.7.5 从我们的 OpenAPI 中发现了全部 31 个线上路由,识别出 /extract 是价格为 0.002 USD 的付费 x402 工具,获取了独立客户端指南,并读取了完整的 reader 架构。这是一次无需钱包的元数据检查,并非已付款交付或客户购买。AgentCash CLI 0.17.1 的 check 命令会加载现有钱包;其发现库无需钱包即可检查架构。我们的独立 quote 无需钱包或密钥。
使用单独安装的发现库重现此只读检查:
node scripts/check-agent-discovery.mjs /path/to/@agentcash/discovery/dist/index.js /private/path/evidence.json
此脚本不会安装软件包、初始化钱包、签名付款或执行付费提取。它会检查当前生产目录、价格、指南和结构化输出架构,以及 x402scan 所能看到的内容:线上 402 探测、可读的 402 正文、带有 og:image 的 HTML 主页、/og.png 和 /status。设置 CHECK_ORIGIN 可检查其他部署。已付款的 HTTP、CLI 和 MCP 交付需要分别提供证据。
无需编写客户端即可使用本地 MCP Agent
捆绑的本地 MCP 适配器可在 Node 20.19+ 上运行,无需安装 npm。默认仅生成报价。显式启用付费模式后,允许单次调用购买,每次上限为 $0.002,并受进程会话额度限制;签名结果未知时,将锁定后续购买。源代码和设置说明。请保留主机的工具审批机制。仅连接远程 MCP 不会自动付款。
阅读长文档中的相关部分
可选的 section 用于选择主 HTML 中完全匹配的可见标题/容器 ID。CLI 中使用 --section,MCP 中使用 section。选择不存在或有歧义时会失败且不收费;返回的范围会明确标出。实际缓存的文档后段示例和范围说明。价格仍为 $0.002。URL 片段本身不会改变范围。
可移植的买家技能
单文件读取器技能为兼容的 Agent 提供报价、授权购买、分段阅读和失败对账工作流。已托管的下载文件和安装上下文。按照宿主提供的流程,将其放入宿主配置的技能位置中名为 spellzcode-x402-reader 的文件夹。安装前请先检查;不会自动安装、创建钱包或提供消费授权。发布本身并不能确保宿主激活或交付已付款内容。
次要入口:比特币手续费数据
同一下载的客户端现已支持 node reader-client.mjs quote-btc-fees 和一次授权的 node reader-client.mjs buy-btc-fees --max-usdc 0.002。无需 URL、npm 配置或比特币密钥。本地 MCP 在共享会话额度下提供 btc_fees_quote/btc_fees_buy。这是用 Base USDC 购买数据,不会发送比特币。设置和限制。静态读取器仍是主要工作流。
早期读取器版本
版本 1.2.0 新增有界 /sitemap 工具,以及设有上限的 quote-sitemap/buy-sitemap 命令。版本 1.1.2 新增本地命令构建器,支持 POSIX/PowerShell 引号处理和三页研究配方,同时保留不可变的 1.1.1 下载文件。读取器 1.1.1 将元数据限制与主要表格文本分开,保留代码中的字面空白和嵌套列表,并在输出限制内闭合被截断的代码围栏。捆绑的 Node 客户端支持无需签名的 quote 和一次设有明确上限的 buy。使用 npm run build:reader 构建客户端和缓存示例。下载的客户端需要 Node 20.19+,且无需项目依赖。下载内容附有校验和和公开源码;密钥保留在买家的进程环境中。
远程 MCP 会公布 extract、sitemap 和 btc-fees 的成功结果 JSON 架构,与 OpenAPI 保持一致。结算前会检查结果。报价和失败会以 isError: true 返回,JSON 位于 content[0].text;只有成功结果才包含 structuredContent。这样一来,通过架构验证的客户端也能使用免费报价。
端点系列
MCP 目录 1.8.1 在现有 32 个工具之外新增 113 个活跃系列工具:涵盖五个网络的区块链读取、本地数据/文本实用工具、公共数据查询和加密随机数实用工具。调用活跃系列工具的费用为 $0.002。实时 OpenAPI 和目录会列出当前路由。读取器下载文件保持在 1.7.6,单独的链客户端保持在 1.0.0。
四个已实现的系列工具已暂停,并从付费发现中排除:/regex/test 暂停,直至执行过程可设定上限;/air-quality、/uv 和 /geocode 暂停,直至配置可用于此商业服务的数据源。直接请求会返回不收费的 503,且不会调用上游。未添加订阅或新增消费。JSON 修复会保留已有效的 JSON 和带引号的文本。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。