twitr.sh

---

⚡ 60 秒で開始

多くの X/Twitter スキルは公式 API をラップしているため、設定は自分で行う必要があります。X 開発者アカウントを登録し、アプリを作成して、OAuth を完了し、トークンを保存して、X に直接支払います。これらのスキルなら、すべて不要です。エージェントのウォレットがリクエストごとに支払い、その支払いがそのまま認証になります。

1 · スキルをインストールします（Node 18+ と PATH 上の git が必要です）。

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"	—

エージェントウォレットを初めて使う場合は、手順を追ったガイドがあるウォレットの設定をご覧ください（AgentCash の初回利用特典で、最大 25 ドルを無料でチャージできることもあります）。

3 · エージェントに何か尋ねます。 最初の呼び出しでは、正確な料金を示す HTTP 402 が返されます。これは見積もりであり、エラーではありません。ウォレットが支払いを行い、自動的に再試行します。5 ドルで数千回の読み取りが可能です。

💡 エージェントには何ができますか？

スキルをインストールしたら、以下のいずれかをコピーして貼り付けてください。

「今週、@vercel はどんな投稿をしていますか？」

「自分の製品について人々が何と言っているか X で検索して、いいね数の多い順に上位 50 件を表示して。英語のみで。」

「競合の @competitor を監視して、何か発表したらすぐに知らせて。」 — リアルタイムモニター。無料のポーリングまたは署名付き Webhook でイベントがエージェントに届きます

「ローンチの告知として、私の文体でツイート案を 3 種類作成して。1 つ選んでから投稿する。」

「このツイートに返信した全員をデータセットとしてエクスポートして。」

「X での活動を管理して。これら 3 つのトピックを監視し、毎朝投稿案をキューに入れて。返信は私の承認を待つようにして。」

📦 スキル

トリガーの境界が明確な、目的を絞った6つのスキルです。互いに重複して起動することはありません。

	スキル	機能
⭐	x-presence	常時稼働のプレゼンス — トピックを監視し、あなたらしい文章を下書きして、スケジュールに沿って投稿し、返信を承認待ちキューに入れます。まずはこちら — 内部でほかのスキルを動かします。
🤖	twitter-automation	自動化の構築ツール — 作成したい自動化（自動返信、スケジューラー、監視、エンゲージメント）を説明すると、基本機能を組み合わせて設計、価格設定、構成します。
🔎	x-twitter-data	リアルタイムのデータ取得 — ツイート、プロフィール、検索、タイムライン、リスト、コミュニティ、トレンド。
🔔	x-twitter-monitor	リアルタイム監視 — 無料のポーリングまたは HMAC 署名付き Webhook で通知します。
✍️	x-twitter-publish	AI で下書きを作成し、接続済みアカウントから投稿、返信、引用します。
📦	x-twitter-research	ダウンロード可能なデータセットとして一括エクスポート — フォロワー、返信したユーザー、リポストしたユーザー。

--skill <name> を指定すると、6つすべてではなく1つだけインストールできます。

x-presence のスケジュール設定については、scheduling.md をご覧ください — Claude Code routines、Hermes cron、OpenClaw cron 用の確認済みコマンドを掲載しています。

👛 ウォレットの設定

AgentCash — コマンドを1つ実行するだけ、約2分で完了し、最大25ドルをあなたが受け取れる可能性があります。

1. オンボーディング（ローカルウォレットを作成し、AgentCash スキルをインストールして、エージェント用に MCP を設定します）：

npx agentcash@latest onboard

まず agentcash.dev/onboard にアクセスして GitHub/X/LinkedIn を接続すると、最大25ドル相当の無料 USDC を受け取れるクレームコードを取得できます。多くの場合、入金せずに数週間これらのスキルを使えます。

2. 資金を入金（ボーナスで足りる場合は省略してください）：

npx agentcash fund

カードでの入金とブリッジをガイドするフローです。最低入金額はありません。

3. 動作を確認 — エージェントに 「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 UI が開きます（Apple Pay、カード、銀行）。

3. 完了です。 エージェントは Base 上で x402 を通じて twitr.sh に支払います。エンドポイントに手動で支払うには、次を実行します： npx awal@latest x402 pay <url>。

pay.sh — Solana Foundation の決済レイヤー。エージェントの CLI をラップします。

1. セットアップ — ウォレットを設定し、使用するツールをラップします：

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

pay は 402/MPP チャレンジを検出し、ローカルウォレットに署名を求めてから、支払い証明を付けて再試行します — Solana 上の USDC を使用します。twitr.sh は Solana x402 をネイティブに受け付けます。

クライアントの1回あたりの上限は厳格な支出制限です。上限を超える呼び出しはできず、失敗した呼び出しに料金は一切かかりません。

X アカウントを接続しますか？ エージェントにパスワードが知られることはありません — エージェントから使い捨てリンクが渡されるので、ご自身のブラウザーで twitr.sh にサインインしてください。アカウントを所有するのはウォレットです。エージェントのウォレットに与えられるのは書き込みアクセス権だけで、その権限を取り消せるのはあなたのみです。SECURITY.md · 詳しい説明をご覧ください。

🐍 Twitter スクレイパー API として使う

エージェントを使わない場合でも、同じツールを HTTP のTwitter / X スクレイパー APIとして利用できます。ツイートの検索、プロフィールやタイムラインの閲覧、フォロワー、返信、いいねのエクスポート、リストやコミュニティの取得が可能です。すべてのエンドポイントは POST https://twitr.sh/api/tools/{tool} で、フラットな JSON ボディを指定します。

支払い方法は 2 つありますが、料金は同じです。

• カード残高 + API キー。 Google で twitr.sh/dashboard にサインインし、カードでチャージして tw_live_… キーを作成し、Bearer トークンとして送信します。
• アカウント不要のウォレット。 認証情報なしで呼び出すと、正確な料金を示す HTTP 402 が返されます。USDC（Base 上の x402 または Solana、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 を 1 週間実行する場合の一般的な料金は、モニター 2 件、返信 12 件、投稿数件で約 $9です。ウォレットで署名する前に、すべての 402 が正確な料金を提示します。

🚫 これらのスキルで行わないこと

プレゼンススキルと公開スキルには、自動フォロー、フォロー解除、いいね、キーワードに反応した返信の機能はありません。

X はこれらを明確に禁止しています。また、公開されているランキングの重みを見ると、フォローはまったくスコア化されない一方で、報告 1 件のスコアは −369.0 です。そのため、禁止されている手法はアカウントを危険にさらすだけでなく、リーチも損ないます。twitter-automation は必要なユーザー向けにすべてのアクションを提供しますが、設計の料金を事前に提示し、明示的な確認を必須とし、アカウントにリスクを及ぼすほどスパム的な設計には警告を表示します。

根拠と参照元：ranking-signals.md · x-rules.md

🔗 リンク

6 つのスキルすべて	https://twitr.sh/skills
エージェントガイド	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 を気に入っていただけましたか？このリポジトリに ⭐ を付けると、ほかのエージェントが見つけやすくなります。