用途
2s.io 是一个按次付费的 x402 API，被称为“几乎万能的 API”。它为 AI 智能体提供跨数百个端点的真实数据，每次调用通过 Base 或 Solana 上的 USDC 支付。本仓库提供适用于所有主流智能体开发语言的 SDK，以及适用于任何支持 MCP 的主机的 MCP 服务器。
主要能力
API 覆盖 113+ 个分组、575+ 个端点，包括：
- AI：网页摘要、翻译、类型化提取、图像描述、转录、截图
- 智能体原语：持久键值内存、智能体间市场（注册/发现/评价）、知识增量（“自日期 Y 以来 X 发生了什么变化”）、原子批量结算
- 控制平面：钱包范围的智能体基础设施——分布式锁/租约、持久消息队列、cron 式定时回调、带扇出的发布/订阅主题
- 存储：按次付费的钱包键控持久化——键值、文档、向量/全文搜索、私有 blob 上传
- Watchers（推送而非轮询）：一次布防，当钱包移动、股票突破价格或公司发布财报时立即收到签名回调
- 安全：CVE 查询（NVD + CISA KEV + EPSS）、电子邮件安全、HTTP 安全头、密码泄露（HIBP）、RPKI、CT 日志、IOC 信誉、CWE/ATT&CK/CAPEC、漏洞利用可用性
- 专利与商标：USPTO 开放数据门户搜索 + 完整文件包装详情 + 文档列表；商标全文搜索 + 状态
- 法律：联邦/州案件搜索、引文验证、OFAC 制裁筛查、联邦公报、CFR 与 USC、意见书、案卷
- 政府：国会法案/投票/议员、FEC 竞选财务、FDA 药品/器械/食品事件 + 召回、OSHA/MSHA、USAspending、EPA 设施、USGS 水（50+ 端点）
- 金融与财政：SEC EDGAR 公司事实、文件、内部交易、13F 持仓；美国财政部债务 + 现金；股票报价；汇率
- 车辆与航空：VIN 解码、召回、投诉、调查（NHTSA）；飞机注册、机场、航班数据
- 健康与医疗：ICD-10/HCPCS/RxNorm、医院质量、Medicare 提供者 + 开放支付、临床试验、药品定价
- 商业与注册：州务卿实体搜索、GLEIF LEI 实体匹配、KYB 筛查、IRS 非营利搜索、银行路由
- 能源、农业、海事与电信：能源价格与生产、USDA 农业、土壤调查、船舶与港口数据、电话/号码情报
- 地理/天气/地球：正向 + 反向地理编码、按 ZIP 的美国天气、NOAA 潮汐、日出/日落、气候站、近期地震、IP 地理定位（单个 + 批量）
- 太空：发射、近距离接近、卫星、系外行星、今晚星空、太空天气
- 互联网：DNS 查询、RDAP whois、TLS 检查、URL 展开（Open Graph）、URL → 干净 Markdown
- 维基百科/学术论文：摘要、多源论文搜索（arXiv + PubMed + Semantic Scholar）
- 加密货币：多链地址验证（BTC、ETH、SOL、LTC、TRX、XRP、BCH）、实时 EVM gas 预言机
- 经济与劳动力：BLS 系列、通胀、世界银行指标、ACS 人口统计、职业、USAJOBS、College Scorecard
- 数据与实用工具：10+ 验证器（IBAN、电子邮件、电话、增值税…）、EDI 解析、ISO 代码、单位/货币转换、哈希、图像压缩、条形码/QR、倒计时 GIF
使用方式
无需账户、API 密钥或信用卡。 买方即时签署 EIP-3009 USDC 授权（Base）或 SPL USDC 转账（Solana），协调者在主网上约 2 秒内验证 + 结算，API 返回类型化数据。价格从 $0.0025/次起。
免费试用：每个端点每小时提供一次免费真实调用——无需密钥、钱包或注册。添加 ?trial=1（或请求头 X-2s-Trial: 1），或将 SDK 切换到试用模式。试用运行真实处理程序并返回真实数据。每小时试用用完后，端点返回正常的 402——去掉 trial 并传入 privateKey/signer 即可按次付费获得无限访问。
Watchers：大多数端点是读取操作。Watchers 则相反：一次布防，2s 在事件发生时推送签名回调——Base/Ethereum/Bitcoin 上的钱包移动、美国股票突破价格、公司发布财报。无需轮询循环，无浪费调用。布防固定 $0.05；回调使用 EIP-191 签名（可离线验证），带指数退避重试，并通过 watchers.status 提供拉取后备。
托管 MCP（按 URL 连接）：不想安装任何东西？将任何 MCP 主机指向托管服务器。使用 Streamable-HTTP；设置请求头 X-EVM-Private-Key: 0x…（Base 上的 USDC），2s 会为每次调用签名 + 结算 x402。权衡：托管签名器意味着您的私钥会经过 2s 的基础设施——对于永不离开您机器的密钥，请在本地运行 npx @2sio/mcp 或使用上述 SDK（更私密、安全的路径）。
30 秒 Claude Desktop 安装：重启 Claude。模型现在可以调用 patents.search、law.sanctions-check、ai.summarize、geocode.address、vehicle.vin-decode、agent.knowledge-delta、security.cve 以及其他 340+ 付费工具——按次付费，无需人工介入。
适用场景
适用于需要为 AI 智能体提供真实世界数据的开发者，涵盖法律、金融、政府、健康、地理、太空、互联网等多个领域。特别适合需要按次付费、无需管理 API 密钥或账户的智能体应用。
限制
- SDK 拒绝签署超过可配置 maxPriceUsd 的支付。没有默认上限（maxPriceUsd 默认为 Infinity）——设置它以选择加入上限。
- 每笔 x402 支付都是单次使用的 EIP-3009 授权，截止时间为 60 秒。不发放津贴；泄露的密钥只能花费签名时钱包中的金额，且只能按广告价格。
- 可选的 onPaymentRequested 钩子允许调用者以编程方式批准/拒绝每次调用。
- 托管 MCP 的签名器意味着私钥会经过 2s 基础设施；本地运行更安全。
链接
- API 站点：https://2s.io
- npm：https://www.npmjs.com/package/@2sio/sdk、https://www.npmjs.com/package/@2sio/mcp
- x402 协议：https://x402.org
- MCP 协议：https://modelcontextprotocol.io
- 实时目录：https://2s.io/api/directory
- OpenAPI 3.1：https://2s.io/api/openapi
- 机器发现清单：https://2s.io/.well-known/x402
- 许可证：MIT，见 LICENSE。
