Scout Packs

Scout Packs — Tiger Operations

经验证的 B2B 潜在客户包和按条计费的潜在客户信息补充查询，面向 AI Agent 销售，通过 x402（Base 上的 USDC，eip155:8453）支付。需求探测定价（2026-10-04）： 每次查询或每个客户包 $0.01。 我们承认该定价与 Scout 的 COGS 相比存在利润倒挂—— 这只是需求探测，并非商业模式。停止门槛：重新定价后 7 天内，来自至少 2 个不同钱包的付费查询达到 ≥3 次。

客户包	潜在客户数	价格	交付方式
scout-pack-25	25	$0.01	付款后立即下载 JSON
scout-pack-50	50	$0.01	按需整理，24 小时内交付
scout-pack-100	100	$0.01	按需整理，24 小时内交付

按条计费的信息补充查询：GET /lookup?query=<company or domain> — 402 付费墙， $0.01 USDC，POST /fulfill-lookup 返回一个经验证的企业邮箱 + 来源 URL + 溯源信息。

综合档案：GET /dossier?domain=<domain> — 402 付费墙， $0.05 USDC，POST /fulfill-dossier 返回一份综合域名档案： RDAP 注册信息 + DNS 基础设施信号、技术栈检测、 可能的企业邮箱模式 + MX 验证，以及单个域名的 SSL/TLS 证书 健康状况；所有信息整合为一份响应，并附带汇总后的 信号列表——一次调用即可获取 /domain-intel、/tech-stack、/email-pattern 和 /ssl-check 的结果，无需分别调用四次。

每条潜在客户信息包含：company_name、city_state、category、contact_email（经验证的企业邮箱）、source_url。

端点

• GET / — 面向用户的首页
• GET /catalog — 客户包和价格（JSON）
• GET /.well-known/x402 — 机器可读的支付条款
• GET /llms.txt — Agent 购买说明
• GET /packs/{25,50,100}/preview — 脱敏预览（邮箱已屏蔽），免费
• GET /packs/{25,50,100} — 返回带有 PAYMENT-REQUIRED（v2）和 X-PAYMENT-REQUIRED（v1）标头的 402
• GET /lookup?query=<company or domain> — 返回包含支付条款（$0.01 USDC）的 402；无匹配结果 → 404
• POST /fulfill — {"tx_hash":"0x...","pack":"25","deliver_to":"..."}
• POST /fulfill-lookup — {"tx_hash":"0x...","query":"<company>"}
• GET /dossier?domain=<domain> — 返回包含支付条款（$0.05 USDC）的 402；综合域名档案：将域名情报、技术栈、邮箱模式和 SSL 检查整合为一次调用
• POST /fulfill-dossier — {"tx_hash":"0x...","domain":"<domain>"}
• GET /skill.md — 潜在客户查询的 Agent 技能文件（Markdown）
• /mcp — MCP 可流式传输的 HTTP 端点（设置 MCP_PROXY_PORT 时，代理到同级 MCP 服务）

接口参考（适用于 Agent/MCP 客户端）

GET /packs/{25,50,100} → 402 Payment Required

• Headers：PAYMENT-REQUIRED = base64(JSON x402 v2 terms)，X-PAYMENT-REQUIRED = base64(JSON x402 v1 terms)
• Body：{error:"payment_required", pack, leads, price_usd, currency:"USDC", network:"eip155:8453", fulfillment, sales_enabled, x402:{x402Version:2, accepts:[{scheme:"exact", network, amount (atomic USDC, 6 decimals), description, mimeType, payTo, maxTimeoutSeconds, asset, extra}], resource:{url, description, mimeType}}, how_to_pay:[...]}
• 卖家地址尚未配置时（当前状态），sales_enabled:false；配置后会自动切换。

POST /fulfill — 请求体 {tx_hash:"0x…", pack:"25"|"50"|"100", deliver_to:"…" (optional)}

• 成功，pack 25 → 200 {receipt:"ok", pack:"scout-pack-25", tx_hash, verified_at, leads:{…25-lead pack JSON…}}
• 成功，pack 50/100 → 200 {receipt:"ok", pack, tx_hash, verified_at, order_id, status:"queued_for_assembly", eta:"within 24 hours of payment confirmation", deliver_to, note}
• 失败 → 402 {error:"payment_not_verified", detail:"sales_paused: receiving address not configured" | "bad_tx_hash" | "already_redeemed" | "tx_not_found" | "tx_not_successful" | "tx_too_old" | "no_matching_usdc_transfer" | "chain_lookup_failed", pay:[…steps…]} 或 400 {error:"unknown_pack"|"bad_json"}

验证规则：交易必须是在 Base 上成功完成的 USDC 转账，金额不少于套餐金额，且转入已配置的收款地址；交易的上链时间须在 30 天内，每个交易哈希只能使用一次。

购买流程

1. GET /packs/25 → 读取 402 条款（payTo、准确的 USDC 金额）。
2. 标准 x402：在 Base 上签署一笔恰好 $0.01 USDC 的 EIP-3009 授权，授权对象为 payTo，然后在 X-PAYMENT（v1）或 PAYMENT-SIGNATURE（v2）Header 中附上签名，重试同一请求。支付将通过 facilitator 验证并结算，随后立即返回 pack 25（50/100 会返回 24 小时内处理的订单收据）。
3. 备用方式：自行在 Base 上向 payTo 转账恰好 $0.01 USDC，然后使用交易哈希调用 POST /fulfill。

支付通过链上验证（Blockscout 免费 API）：交易必须是在 Base 上成功完成的 USDC 转账，金额不少于套餐金额，且转入收款地址。交易哈希只能使用一次（防止重放）；超过 30 天的交易会被拒绝。

配置

• SCOUTPACKS_RECEIVING_ADDRESS — 接收 USDC 的 Base 地址。未设置（或设为零地址）时，端点将以仅预览模式运行：402 响应体和 /.well-known/x402 中的 sales_enabled=false，且 /fulfill 会拒绝所有请求。
• SCOUTPACKS_PUBLIC_BASE — 用于 402 resource 字段的公开 URL。
• PORT — 默认值为 8000。
• MCP_PROXY_PORT — 可选（例如 8001）；设置后，/mcp 会反向代理到该端口上的同级 MCP 流式 HTTP 服务（mcp/http_server.py）——一次部署即可同时提供 x402 API 和持久 HTTPS MCP 端点。

部署

./run.sh &                                   # localhost:8000

自 2026-10-02 起，生产环境运行于 Railway — https://scout-packs-production.up.railway.app 是唯一的生产端点。 旧的 localtunnel 路径（lt-proxy.js、loca.lt 子域名）已停用，是于 2026-10-02 因长期出现 503 错误而退役的旧方案。在常规基础设施上进行全新部署时， cloudflared tunnel --url http://127.0.0.1:8000 仍可照常运行。

然后在开放索引上注册，例如 402 Index： 使用 {url, name, protocol:"x402", description, price_usd, payment_asset:"USDC", payment_network:"eip155:8453", category:"data", tags:[...]} 调用 POST https://402index.io/api/v1/register。

MCP 服务（供 Agent 客户端使用）

AI Agent 也可以通过 MCP 服务，在 MCP 客户端 （Claude Desktop、Cursor、MCP Inspector、Agent 框架）中发现并购买数据包， 路径为 mcp/：

• list_packs — 免费。数据包大小、价格、实时销售状态、脱敏样例。
• buy_pack — 返回确切的 x402 付款条款和分步流程； 购买 Agent 使用自己的钱包向端点付款。绝不转移资金，也绝不 持有密钥。

快速开始（Python 3.10+，仅安装 mcp SDK）：

cd mcp && python3 -m venv .venv && .venv/bin/pip install mcp
BASE_URL=https://<endpoint-url> .venv/bin/python scout_packs_mcp.py

或在发布到 PyPI 后，设置 BASE_URL 并运行 uvx scout-packs-mcp。 完整文档：mcp/README.md。注册目录： mcp/REGISTRIES.md。