twitr.sh

---

⚡ Start in 60 seconds

Most X/Twitter skills wrap the official API, so the setup is yours: register an X developer account, create an app, complete OAuth, store the tokens, and pay X directly. These skip all of it — your agent's wallet pays per request, and that payment is the authentication.

1 · Install the skills (needs Node 18+ and git on PATH):

npx skills add lnvestor/twitr-skills

Claude Code users can install from the plugin marketplace instead — either path works:

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

2 · Get a wallet. Any x402/MPP wallet works — each one's own documented command:

	Wallet	Try it	Pays on
	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"	—

First time with agent wallets? → Wallet setup has step-by-step guides (AgentCash's onboarding bonus can even fund you up to $25 for free).

3 · Ask your agent something. The first call returns HTTP 402 with the exact price — that's the quote, not an error. Your wallet pays and retries automatically. $5 covers thousands of reads.

💡 What can my agent do?

Copy-paste any of these once the skills are installed:

"What is @vercel posting about this week?"

"Search X for what people are saying about my product — top 50 by likes, English only."

"Watch @competitor and tell me the moment they announce something." — a real-time monitor; events reach your agent by free polling or signed webhook

"Draft 3 tweet variants announcing our launch in my voice — I'll pick one, then post it."

"Export everyone who replied to this tweet as a dataset."

"Run my X presence: watch these 3 topics, queue drafts every morning, replies wait for my approval."

📦 The skills

Six focused skills with explicit trigger boundaries, so they don't fire over each other.

	Skill	What it does
⭐	x-presence	Unattended presence — watch topics, draft in your voice, publish on a schedule, queue replies for approval. Start here — it drives the others internally.
🤖	twitter-automation	The automation builder — describe the automation you want (auto-reply, scheduler, watcher, engagement) and it designs, prices, and wires it from the primitives.
🔎	x-twitter-data	Live reads — tweets, profiles, search, timelines, lists, communities, trends.
🔔	x-twitter-monitor	Real-time monitors, delivered by free polling or HMAC-signed webhooks.
✍️	x-twitter-publish	Draft with AI, then post, reply, or quote through a connected account.
📦	x-twitter-research	Bulk exports — followers, repliers, reposters — as downloadable datasets.

Install one instead of all six with --skill <name>.

Scheduling x-presence? See scheduling.md — verified commands for Claude Code routines, Hermes cron, and OpenClaw cron.

👛 Wallet setup

AgentCash — one command, ~2 minutes, and it may pay you up to $25.

1. Onboard (creates a local wallet, installs the AgentCash skill, and wires up MCP for your agent):

npx agentcash@latest onboard

Visiting agentcash.dev/onboard first and connecting GitHub/X/LinkedIn gets you a claim code worth up to $25 in free USDC — often enough to run these skills for weeks without depositing anything.

2. Fund it (skip if the bonus covered you):

npx agentcash fund

Guided flow with card on-ramp and bridging. No minimum.

3. Check it works — ask your agent "What is my AgentCash balance?" If it answers with a number, you're done.

Claude Code users can alternatively install just the MCP server: claude mcp add agentcash --scope user -- npx -y agentcash@latest

Coinbase Agentic Wallet (awal) — email OTP login, fund with Apple Pay/card.

1. Sign in (a 6-digit code lands in your email; verify it):

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

2. Fund it — npx awal@latest show opens the Coinbase Onramp UI (Apple Pay, card, bank).

3. Done. Your agent pays twitr.sh over x402 on Base; to pay an endpoint by hand: npx awal@latest x402 pay <url>.

pay.sh — Solana Foundation's payment layer; wraps your agent CLI.

1. Set up the wallet, then wrap the tool you use:

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

pay detects the 402/MPP challenge, asks your local wallet to sign, and retries with payment proof — USDC on Solana. twitr.sh accepts Solana x402 natively.

Your client's per-call cap is a hard spend limit — no call can exceed it, and failed calls are never charged.

Connecting an X account? Your agent never sees your password — it hands you a single-use link and you sign in on twitr.sh in your own browser. Your wallet owns the account; the agent's wallet only gets write access, and only you can revoke it. See SECURITY.md · full write-up.

🐍 Use it as a Twitter scraper API

No agent? The same tools are a plain HTTP Twitter / X scraper API: search tweets, read profiles and timelines, export followers, replies and likes, pull lists and communities. Every endpoint is POST https://twitr.sh/api/tools/{tool} with a flat JSON body.

Two ways to pay, same prices:

• Card balance + API key. Sign in at twitr.sh/dashboard with Google, top up by card, create a tw_live_… key, and send it as a Bearer token.
• Wallet, no account. Call without credentials, get HTTP 402 with the exact price, pay in USDC (x402 on Base or Solana, MPP on Tempo), retry. x402-aware clients do this automatically.

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));

Volume tools bill per returned item and need resultsLimit, so you never pay for more than you asked for. Full tool list and inputs: twitr.sh/tools · OpenAPI.

💸 What it costs

Action	Price
Reading events from a monitor	free
Drafting a post	~$0.0024
A read or search	~$0.0012 / item
A post or reply	$0.036
A monitor	~$0.025 / hour

A typical week running x-presence — two monitors, a dozen replies, a few posts — is about $9. Every 402 quotes the exact price before your wallet signs anything.

🚫 What these skills will not do

The presence and publish skills contain no automated following, unfollowing, or liking, and no keyword-triggered replies.

X prohibits these by name, and its published ranking weights show follows aren't scored at all while a single report scores −369.0 — so the banned tactics cost reach as well as risking the account. twitter-automation exposes the full action set for users who need it, but it prices every design up front, requires explicit confirmation, and warns when a design is spam-shaped enough to risk the account.

Reasoning and sources: ranking-signals.md · x-rules.md

🔗 Links

All six skills	https://twitr.sh/skills
Agent guide	https://twitr.sh/skill.md
Docs	https://twitr.sh/docs
Security model	https://twitr.sh/agent-security
OpenAPI 3.1	https://twitr.sh/openapi.json
MCP	POST https://twitr.sh/api/mcp
Payment discovery	x402 · MPP
Explorer listings	x402scan · agentcash

License

MIT — see LICENSE.

_{Independent service. Not affiliated with X Corp. "X" and "Twitter" are trademarks of X Corp.}

---

Enjoying twitr-skills? A ⭐ on this repo helps other agents find it.