twitr.sh

---

⚡ 60 秒快速开始

大多数 X/Twitter 技能都封装了官方 API，因此设置工作都得由你来做：注册 X 开发者账号、创建应用、完成 OAuth、保存令牌，并直接向 X 付费。这些技能省去了所有这些步骤 — 你的 Agent 钱包按请求付费，而这笔付款本身就是身份验证。

1 · 安装技能（需要 Node 18+，且 git 位于 PATH 中）：

npx skills add lnvestor/twitr-skills

Claude Code 用户也可以从插件市场安装 — 两种方式都可以：

/plugin marketplace add lnvestor/twitr-skills
/plugin install twitr-skills@twitr

**2 · 获取钱包。**任何 x402/MPP 钱包都可以 — 每种钱包都有自己的文档命令：

	钱包	试用	支持的网络
	AgentCash ⭐	npx agentcash try https://twitr.sh	Base · Solana · Tempo
	awal（Coinbase）	npx awal x402 bazaar search twitr.sh	Base
	pay.sh（Solana Foundation）	pay curl https://twitr.sh	Solana
	Poncho	tryponcho.com/m/twitr.sh	—
	Circle Agent Wallet	circle services search "twitr.sh"	—

第一次使用 Agent 钱包？→ 钱包设置提供分步指南（AgentCash 的新手奖励甚至可以免费为你提供最高 $25）。

**3 · 向你的 Agent 提问。**首次调用会返回 HTTP 402，并显示准确价格 — 这是报价，不是错误。你的钱包会自动付款并重试。$5 足以支付数千次读取。

💡 我的 Agent 能做什么？

安装技能后，可以复制粘贴以下任意一句：

“@vercel 这周都在发布什么内容？”

“搜索 X，看看大家在说我的产品什么 — 按点赞数排序取前 50 条，仅限英文。”

“监控 @competitor，一有新公告就告诉我。” — 实时监控；事件会通过免费轮询或签名 Webhook 发送给你的 Agent

“用我的语气起草 3 个推文版本，宣布我们的发布 — 我选一个后再发布。”

“将这条推文的所有回复者导出为数据集。”

“管理我的 X 动态：监控这 3 个话题，每天早上排好草稿，回复则等我批准。”

📦 这些技能

六项专注型技能，触发边界明确，彼此不会冲突。

	技能	功能
⭐	x-presence	无人值守运营——关注话题、用你的口吻撰写草稿、按计划发布，并将回复加入队列等待审核。从这里开始——它会在内部调用其他技能。
🤖	twitter-automation	自动化构建器——描述你想要的自动化（自动回复、计划任务、监控、互动），它会基于基础功能进行设计、报价并完成配置。
🔎	x-twitter-data	实时读取——推文、个人资料、搜索、时间线、列表、社群、趋势。
🔔	x-twitter-monitor	实时监控，可通过免费轮询或 HMAC 签名的 Webhook 推送。
✍️	x-twitter-publish	使用 AI 起草，然后通过已连接的账号发布、回复或引用推文。
📦	x-twitter-research	批量导出——关注者、回复者、转发者——并生成可下载的数据集。

使用 --skill <name> 安装其中一项，无需全部安装。

要安排 x-presence 的计划任务？请参阅 scheduling.md——其中列出了适用于 Claude Code routines、Hermes cron 和 OpenClaw cron 的已验证命令。

👛 钱包设置

AgentCash — 只需一条命令，约 2 分钟，还可能为< i>你赚取最高 $25。

1. 完成注册（创建本地钱包、安装 AgentCash 技能，并为你的 Agent 配置 MCP）：

npx agentcash@latest onboard

先访问 agentcash.dev/onboard 并连接 GitHub/X/LinkedIn， 即可获得价值最高 $25 的免费 USDC的领取码——通常足以让这些技能运行数周， 无需存入任何资金。

2. 充值（如果奖励金额足够，可跳过）：

npx agentcash fund

提供银行卡充值和跨链转移的引导流程。无最低金额要求。

3. 检查是否正常——询问你的 Agent：“我的 AgentCash 余额是多少？” 如果它回答了一个数字， 就大功告成了。

Claude Code 用户也可以选择只安装 MCP 服务： claude mcp add agentcash --scope user -- npx -y agentcash@latest

Coinbase Agentic Wallet (awal) — 通过电子邮件 OTP 登录，使用 Apple Pay/银行卡充值。

1. 登录（你会收到一封包含 6 位验证码的邮件；完成验证）：

npx awal@latest auth login
npx awal@latest auth verify <flowId> <otp>

2. 充值——npx awal@latest show 会打开 Coinbase Onramp 界面（Apple Pay、银行卡、银行转账）。

3. 完成。 你的 Agent 会通过 Base 上的 x402 向 twitr.sh 付款；如需手动向某个端点付款： npx awal@latest x402 pay <url>。

pay.sh — Solana Foundation 的支付层；封装你的 Agent 命令行工具。

1. 设置钱包，然后封装你使用的工具：

pay setup
pay claude   # or: pay curl https://twitr.sh/api/tools/x_read ...

pay 会检测 402/MPP 挑战，请求你的本地钱包签名，并附上付款凭证重试——使用 Solana 上的 USDC。twitr.sh 原生支持 Solana x402。

客户端的单次调用上限是硬性消费限额——任何调用都不能超出，并且失败的调用绝不会收费。

要连接 X 账号？ 你的 Agent 永远不会看到你的密码——它会提供一个一次性链接，你可以在自己的浏览器中登录 twitr.sh。账号归你的钱包所有；Agent 的钱包只有写入权限，而且只有你可以撤销该权限。请参阅 SECURITY.md · 完整说明。

🐍 将其用作 Twitter 抓取 API

没有 Agent？同一组工具也可以作为纯 HTTP Twitter / X 抓取 API 使用：搜索推文、读取个人资料和时间线、导出关注者、回复和点赞、获取列表和社群。每个端点都是 POST https://twitr.sh/api/tools/{tool}，并接受扁平 JSON 请求体。

两种付款方式，价格相同：

• 卡余额 + API 密钥。 使用 Google 登录 twitr.sh/dashboard，通过银行卡充值，创建一个 tw_live_… 密钥，并将其作为 Bearer 令牌发送。
• 钱包，无需账户。 不带凭据调用，收到含确切价格的 HTTP 402 后，通过 USDC 付款（在 Base 或 Solana 上使用 x402，或在 Tempo 上使用 MPP），然后重试。支持 x402 的客户端会自动完成这些操作。

curl

curl -X POST https://twitr.sh/api/tools/x_search \
  -H "Authorization: Bearer $TWITR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"q":"from:nasa since:2026-01-01","queryType":"Latest","resultsLimit":20}'

Python — examples/python/search_tweets.py

import os, requests

r = requests.post(
    "https://twitr.sh/api/tools/x_search",
    headers={"Authorization": f"Bearer {os.environ['TWITR_API_KEY']}"},
    json={"q": "from:nasa", "queryType": "Latest", "resultsLimit": 20},
)
for tweet in r.json()["items"]:
    print(tweet["createdAt"], tweet["text"][:80])

Node — examples/node/search-tweets.mjs

const res = await fetch("https://twitr.sh/api/tools/x_search", {
  method: "POST",
  headers: { authorization: `Bearer ${process.env.TWITR_API_KEY}`, "content-type": "application/json" },
  body: JSON.stringify({ q: "from:nasa", queryType: "Latest", resultsLimit: 20 }),
});
for (const t of (await res.json()).items) console.log(t.createdAt, t.text.slice(0, 80));

批量工具按返回的项目数计费，并且需要设置 resultsLimit，因此你绝不会为超出所需数量的内容付费。完整的工具列表和输入参数：twitr.sh/tools · OpenAPI。

💸 费用

操作	价格
读取监控事件	免费
起草帖子	~$0.0024
读取或搜索	~$0.0012 / 项
发布帖子或回复	$0.036
监控	~$0.025 / 小时

运行 x-presence 的典型一周用量——两个监控、十几条回复、几篇帖子——约为 $9。每个 402 响应都会在你的钱包签署任何内容之前报出确切价格。

🚫 这些技能不会执行的操作

presence 和 publish 技能不包含自动关注、取消关注或点赞，也不会根据关键词自动回复。

X 明确禁止这些操作；其公布的排名权重显示，关注行为根本不会计分，而单次举报的分数为 −369.0——因此，违规策略不仅会让账号面临风险，还会降低触达率。twitter-automation 为有需要的用户提供完整的操作集，但会预先列明每种设计的费用，要求明确确认，并在设计具有足够明显的垃圾信息特征、可能危及账号时发出警告。

推理依据和来源：ranking-signals.md · x-rules.md

🔗 链接

全部六项技能	https://twitr.sh/skills
Agent 指南	https://twitr.sh/skill.md
文档	https://twitr.sh/docs
安全模型	https://twitr.sh/agent-security
OpenAPI 3.1	https://twitr.sh/openapi.json
MCP	POST https://twitr.sh/api/mcp
付款发现	x402 · MPP
浏览器目录	x402scan · agentcash

许可证

MIT — 详见 LICENSE。

_{独立服务。与 X Corp. 无关联。“X”和“Twitter”是 X Corp. 的商标。}

---

喜欢 twitr-skills？在此仓库点个 ⭐，能帮助其他 Agent 发现它。