______________________________________________________________________
产品名称：x402-x-tweet-fetcher description:通过Solana（USDC）上的x402添加Xcatcher点，获得API密钥，创建X爬网任务，轮询状态，并下载XLSX结果。 主页：https://xcatcher.top/docs/ 用户可调用：true 元数据：｛“openclaw”：｛”表情符号“：”🐦“，”主页“：”https://xcatcher.top/docs/“，”requires“：｛”bins“：\[”curl“，”jq“，”base64“\]，”env“：\[“XCATCHER_API_KEY”\]｝，”primaryEnv“：”XCATCHER-API_KEY“｝｝
Xcatcher（x402+任务）
使用此技能可以：
- 在Solana（USDC）上通过x402购买积分，
- 获取API密钥，
- 创建爬行任务，
- 轮询任务状态，
- 下载XLSX结果。
基本URL:https://xcatcher.top\ REST基础：https://xcatcher.top/api/v1\ 可选健康：https://xcatcher.top/mcp/health
需求
- curl、jq、base64
- 集
XCATCHER_API_KEY对于经过身份验证的呼叫（如果没有，您将在步骤4中获得它）。
积分定价（任务成本）
- 模式=正常：1分/用户
- 模式=深度：10分/用户
- 估计成本=用户数×（模式==正常？1:10）
- 支撑链：基础/溶胶
不要硬编码任何USDC→积分率。始终信任报价回复。
______________________________________________________________________
0）可选健康检查
基础=“https://xcatcher.top" curl-s“$BASE/mcp/health” 回声
______________________________________________________________________
1） 获取x402报价（积分→ Solana USDC付款说明）
笔记：
- 引号过期很快（通常约60秒）。收到报价后立即付款。
基础=“https://xcatcher.top" 点数=1
curl-s“$BASE/api/v1/x402/quote？points=$points”| tee quote.json 回声
QUOTE_ID=$（jq-r'.QUOTE_ID'QUOTE.json） USDC_MINT=$（jq-r'.eccepts.solana.resset'quote.json） PAY_TO=$（jq-r'.eccepts.solana.payTo'quote.json） AMOUNT_ATOMIC=$（jq-r'.eccepts.solana.maxAmountRequired'quote.json）
echo“QUOTE_ID=$QUOTE_ID” echo“USDC_MINT=$USDC_MINT” echo“PAY_TO=$PAY_TO” echo“AMOUNT_ATOMIC=$AMOUNT_ATOMIC” echo“USDC_AMOUNT=$（python3-\<\<'PY' 导入json q=json.load（打开（“quote.json”）） amt=int（q\[“接受”\]\[“solana”\]\[“所需最大金额”\]） 打印（amt/1_000_000） Python )" 回声
QUOTE_ID必须保存
2） 在Solana主网上支付美元
将USDC（SPL）发送到PAY_to，至少获得AMOUNT_ATOMIC（USDC有6位小数）。\ 记录Solana事务签名，然后在下面设置它。
SOL_SIG=“你的SOLANA_TX_签名”
______________________________________________________________________
3） 构建PAYMENT-SIGNATURE标头（UTF-8 JSON的base64）
规则：
- Base64编码一次（无双重编码）。
- 不要将标头值括在额外的引号中。
付款_签名_B64=$（jq-nc-arg sig“$SOL_sig” \ '｛“x402Version”：1，“scheme”：“exact”，“network”：“solana:mainnet”，“payload”：｛“signature”：$sig｝｝' \ |base64 | tr-d'\\n'）
echo“付款_签名_B64=$付款_签名_B64” 回声
______________________________________________________________________
4） 购买积分（quote_id+支付菜单-签名→ api_key）
基础=“https://xcatcher.top"
curl-sS-X POST“$BASE/api/v1/x402/buy_points” \ -H“内容类型：应用程序/json” \ -H“付款签名：$付款_签名_B64” \ -d“$（jq-nc-arg q”$QUOTE_ID“{QUOTE_ID:$q}'）” \ |tee buy.json 回声
API_KEY=$（jq-r'.API_KEY'buy.json） echo“API_KEY=$API_KEY” export XCATCHER_API_KEY=“$API_KEY” echo“XCATCHER_API_KEY导出。” 回声
______________________________________________________________________
5） 验证余额（必须执行）
基础=“https://xcatcher.top" curl-s“$BASE/api/v1/me” \ -H“授权：承载$XCATCHER_API_KEY” \ |jq。 回声
如果你在这里得到402或更高：
- 最常见的原因：报价过期或付款证明无效。
- 修复：重做步骤1→ 4 新报价和新付款。
______________________________________________________________________
6） 创建爬网任务
规则：
- 用户是X个没有“@”的用户名
- 始终提供幂等密钥
- 如果重试相同的逻辑请求，请重用相同的幂等密钥
基础=“https://xcatcher.top" MODE=“正常” IDEM=“test-idm-001” USERS_JSON='\[“用户1”，“用户2”\]'
echo“ESTIMATED_COST_POINTS=$（python3-\<\<‘PY’ 导入json、os users=json.loads（os.environment.get（“users_json”，“\[\]”）） mode=os.environment.get（“mode”，“normal”） 如果模式==“正常”，则per=1，否则为10 打印（len（用户）\*per） Python )" 回声
curl-sS-X POST“$BASE/api/v1/tasks” \ -H“授权：承载$XCATCHER_API_KEY” \ -H“内容类型：应用程序/json” \ -d“$（jq-nc--arg模式”$mode“--arg幂等”$idem“--argjson用户”$users_JSON“ \ “{模式：$mode，用户：$users，幂等键：$idem}” \ |tee-task.json | jq。 回声
TASK_ID=$（jq-r'.TASK_ID'TASK.json） echo“TASK_ID=$TASK_ID” 回声
______________________________________________________________________
7） 轮询任务状态，直到准备就绪
当存在download_url或result_path时停止。
基础=“https://xcatcher.top" 虽然是真的；做 J=$（curl-sS“$BASE/api/v1/任务/$TASK_ID”-H“授权：承载器$XCATCHER_api_KEY”） echo“$J”|jq'{task_id、状态、状态码、更新时间、错误消息、结果路径、下载url}' HAS=$（echo“$J”|jq-r'（.download_url//.result_path//“”）|length'） 如果\[“$HAS”-gt 0\]；然后 echo“完成” 打破 飞 睡眠5 完成 回声
______________________________________________________________________
8） 下载结果（XLSX）
下载需要相同的Bearer令牌；结果不公开。
BASE=“https://xcatcher.top” curl-s-L-o“任务\_${task_ID}.xlsx” \ -H“授权：承载$XCATCHER_API_KEY” \ “$BASE/api/v1/tasks/$TASK_ID/下载”
echo“已保存：任务\_${task_ID}.xlsx” 回声
______________________________________________________________________
故障处理
- 401：承载令牌丢失/无效→ 通过buy_points获取API密钥或正确设置XCATCHER_API_key。
- 402：报价/证明无效或已过期→ 重做报价+支付+购买积分（步骤1-4）。
- 429：费率限制→ 退避；如果存在，请尊重重试。
- 任务卡住/上游问题→ 报告清楚；如果需要，可以增加轮询间隔。