x-api

x-api スキルの概要

x-api でできること

x-api スキルは、X/Twitter API を使ったプログラムによる投稿、読み取り、検索、基本的な分析を支援します。たとえば「この更新を投稿して」「直近のメンションを取得して」といった曖昧な依頼を、適切な認証方式、エンドポイントの選定、リクエスト形式に落とし込む x-api スキルが必要なときに、特に役立ちます。

どんな人がインストールすべきか

ボット、SNS 自動化、コンテンツ配信パイプライン、X のデータを必要とする社内ツールを作るなら x-api をインストールしてください。特に、読み取り専用なのか、ユーザーコンテキストでの書き込み権限が必要なのか、検索中心なのかを判断する必要がある API Development タスクに向いています。

何が便利なのか

x-api の主な価値は、実務に即した切り分けにあります。アプリ専用の読み取りには bearer token、投稿やアカウント操作には OAuth 1.0a を使う、というように用途を分けて案内してくれるため、権限、レート制限、そして実際に API が必要とする入力項目について、実装前の迷いを減らせます。

x-api スキルの使い方

スキルをインストールして読み込む

ディレクトリの x-api 向けインストール手順を使ったうえで、まず SKILL.md を読んでください。環境が対応しているなら、次でインストールできます:

npx skills add affaan-m/everything-claude-code --skill x-api

その後、スキルが案内する関連リポジトリの文脈も確認します。この repo では主要ソースは skills/x-api/SKILL.md で、補完用の rules/、resources/、ヘルパースクリプトはなく、不足部分を別ファイルで埋める構成にはなっていません。

スキルに正しいタスクの形を与える

x-api usage は、最初に「何をするか」「どのアクセス権が必要か」「何を対象にするか」の 3 点を示すと最も機能します。たとえば「bearer token で Claude Code に関する最近の投稿を検索して」「OAuth 1.0a の user context でスレッドを投稿して」のように伝えてください。単に「X API の使い方を教えて」よりずっと有効です。意図を正しい認証方式とエンドポイントのパスに対応づけやすくなるからです。

必要な入力を具体的に伝える

読み取りフローでは、検索クエリ、対象期間、取得件数、公開データが必要なのかアカウント固有データが必要なのかを含めてください。書き込みフローでは、投稿本文を正確に、スレッド化が必要かどうか、メディアや返信に制約があるかを伝えます。x-api for API Development として組み込む場合は、実行環境、シークレットの保管方法、Python・JavaScript・shell のどれでサンプルコードが必要かも明記してください。

ソースはこの順で読む

まず SKILL.md を開き、次に認証のセクションと “When to Activate” のガイダンスを確認してください。そこを見れば、その依頼がこのスキルの対象かどうかが分かります。自分のワークフローに組み込むなら、コード例ではなく判断ロジックから先に写してください。x-api の導入でつまずく最大要因は、たいてい認証方式の選択だからです。

x-api スキル FAQ

x-api は投稿専用ですか？

いいえ。x-api スキルは、投稿、タイムラインの読み取り、最近のコンテンツ検索、分析向けの取得までカバーします。単に文章を作りたいだけなら一般的なライティングプロンプトで十分ですが、API 経由で X に実際に内容を届けたいなら x-api のほうが適しています。

使う前に OAuth を理解している必要はありますか？

OAuth の専門家である必要はありませんが、タスクが app-only の読み取りアクセスなのか、user-context の書き込みアクセスなのかは把握しておく必要があります。そこがこの x-api guide の最も重要な境界であり、どの認証情報を用意すべきかを決める基準になります。

どんなときにこのスキルを使わないべきですか？

一度だけ手動で SNS 投稿したいだけなら、組織が X API アクセスを承認していないなら、または安全な環境変数を用意できないなら、x-api は使わないでください。複数プラットフォームにまたがる広いソーシャルリスニングが必要な場合にも不向きです。スキルは X 専用だからです。

x-api スキルを改善する方法

エンドポイントだけでなく、達成したい結果を伝える

入力が具体的であるほど、x-api の出力もよくなります。たとえば「API call を作って」ではなく、「claude code を検索して 10 件返し、env vars から取得した bearer token を使う Python 例を書いて」と依頼してください。成功条件を具体化すると、スキルが一般論や不完全な例に流れにくくなります。

認証と権限の制約を先に渡す

失敗の多くは、アクセス情報の不足が原因です。bearer-token access があるのか、OAuth 1.0a の user context が使えるのか、両方あるのかを伝えてください。さらに、保存済みシークレットが使えない、DM は扱わない、読み取り専用である、といった制約も添えます。そうすれば、実際には使えない認証フローを提案されるのを防げます。

最初に動くリクエストから段階的に広げる

まずは 1 つの endpoint と 1 つの狭いユースケースから始め、そこから広げてください。良い x-api ワークフローは、認証を確認し、小さな読み取りリクエストを実行し、レート制限の挙動を確かめ、その後に投稿や分析を追加する流れです。最初の出力が抽象的すぎるなら、より広い書き換えを求めるのではなく、正確な request、期待する response shape、最小限の error handling を依頼してください。