Hermes Agent で Twitter/X のデータを使う

#Hermes Agent は単独で Twitter を読めますか？

読めます。標準で付属する2つの経路を通してで、どちらも X 自身のレートで課金されます。Nous Research のオープンソースエージェントである Hermes Agent には、x_search ツールと、xurl という同梱スキルがあります。必要なキーが違い、返ってくるものも違います。

• x_search は質問を xAI のサーバーに送ります。そこで Grok が X を検索し、使った投稿へのリンク付きで回答を書きます。hermes tools で有効にし、XAI_API_KEY か、SuperGrok または X Premium+ のログインが必要で、読み取りしかできません。Hermes の x_search のドキュメント（新しいタブで開きます）は、サブスクリプションのログインでは「with no citations」（引用なし）で回答されると警告しているので、実際の投稿を得るには有料のキーが必要です。
• xurl は X 公式のコマンドラインツールを、スキルとして包んだものです。公式 X API から生の投稿とプロフィールの JSON を返し、あなたのアカウントとして投稿、返信、いいね、DM の送信もできます。最初の呼び出しの前に、xurl のスキルページ（新しいタブで開きます）が明記しているとおり、developer.x.com でアプリを作成し、エージェントの外で OAuth によるサインインを行います。

どちらの経路も、X データをアイテム単位で課金します。xAI の X Search の料金（新しいタブで開きます）は、取得したすべての投稿（親投稿と引用された投稿を含む）を数え、さらにモデルのトークンが加わります。公式 X API は料金表（新しいタブで開きます）どおりに課金し、月間300万件の投稿読み取りで止まり、その先は Enterprise 契約になります。

• x_search

  必要なもの

  xAI の API キー、または SuperGrok か X Premium+ のログイン

  返すもの

  投稿リンク付きの、Grok による文章の回答

  投稿1,000件あたりの料金

  $5.00とトークン料金、プロフィールは$10.00

• xurl スキル

  必要なもの

  X の開発者アプリ、OAuth サインイン、前払いクレジット

  返すもの

  生の投稿とプロフィールの JSON、投稿も可能

  投稿1,000件あたりの料金

  $5.00、プロフィールは$10.00

2026年11月22日からは、公式 X API は各投稿と一緒に返される投稿者にも、1ユーザー$0.010を課金します（X の告知（新しいタブで開きます））。20人の異なる投稿者による20件の投稿を返すページは、$0.10から$0.30に上がります。ほかの X データの取得元は、外部ツールがみなそうであるように、config.yaml の MCP サーバーか、スキルとして Hermes に加わります。

#設定エントリ1つで Hermes Agent に X データを追加する

これらのレートのほんの一部で Hermes Agent に X を読ませるには、Twitter（X）API 兼スクレイピングツールである Sorsa API を MCP サーバーとして追加します。~/.hermes/config.yaml に sorsa ブロックを1つ置くだけで、読み取りしかしないツール40個が、キー1つでエージェントに渡されます。ツイートは1,000件あたり$0.014から、無料の開始分を含め、どのプランも毎秒20リクエストで動きます。申請が必要な X の開発者アカウントはなく、あなた自身の X アカウントも関係しません。

Sorsa API は、アイテムではなく呼び出しに対して課金します。検索1回で約20件の投稿が返り、プロフィール1回の呼び出しで最大100件のプロフィールが返り、すべての投稿に投稿者の完全なプロフィールが追加料金なしで付いてきます。サーバーは npm から入手し、Hermes が npx で起動します。node -v がバージョン18以降を示すことを確認してください。

1. キーを取得する。 Sorsa API にサインアップします。キーはダッシュボードの API キーのページにあります。新しいアカウントには、無料の100リクエストが付き、カードは不要で、使い切るまで残ります。

2. シークレットとして保存する。 hermes config set は、大文字の名前を ~/.hermes/.env に書き込みます。Hermes がキーを保管するファイルです。

   hermes config set SORSA_API_KEY YOUR_API_KEY
   

3. サーバーを追加する。 ~/.hermes/config.yaml の mcp_servers の下に、次を貼り付けます（ネイティブの Windows では、フォルダは %LOCALAPPDATA%\hermes です）。Hermes はサーバーを起動するときに、.env から ${SORSA_API_KEY} を埋めます。

   mcp_servers:
     sorsa:
       command: "npx"
       args: ["-y", "sorsa-mcp"]
       env:
         SORSA_API_KEY: "${SORSA_API_KEY}"
       supports_parallel_tool_calls: true
   

4. テストする。 hermes mcp test sorsa が接続して、40個のツールを一覧表示します。すでに開いているセッションでは /reload-mcp と入力します。稼働中のメッセージングゲートウェイは、約1分以内に新しいエントリを自動で取り込みます。

5. 最初の質問をしてみる。「Sorsa API のリクエストは残りいくつ？」と聞くと、Hermes は mcp_sorsa_get_key_usage_info を呼び出します。これは GET /key-usage-info（新しいタブで開きます） を読み取るもので、コストはかかりません。数字が返れば、チェーンが動いている証拠です。キーを打ち間違えていると、401「invalid api key」が返ります。

   知っておきたいこと

   キーがすでに .env にあっても、env ブロックは残してください。Hermes は、MCP のドキュメント（新しいタブで開きます）にあるとおり、ローカルの MCP サーバーに、システム変数の安全な基本セットと、env の下に挙げた変数だけを渡します。ブロックを外すと、sorsa-mcp はキーなしで起動します。11月2日にその状態で起動したところ、すぐに「Missing SORSA_API_KEY environment variable」で停止し、エージェントにはツールが届きませんでした。

supports_parallel_tool_calls: true を指定すると、Hermes は複数の Sorsa API 呼び出しを同時に実行できます。Hermes のドキュメントは、これをツールが書き込みをしないサーバーにだけ勧めています。Sorsa API のツールはすべて読み取りで、キー1つあたり毎秒20リクエストを処理できるので、一連の照会が順番ではなく一度に実行されます。

#Hermes が見られる X ツールと、使ってよい金額を決める

Hermes では、MCP サーバーごとに独自の制限を設けられます。X データに合うのは3つです。どのツールを読み込むか、チャットがどこまで進んでよいか、呼び出しにあなたの承認が必要か、です。

• ツール。 tools.include は、名前を挙げたツールだけを読み込みます。40個のツールの説明は約2万3千文字になるので、検索とプロフィールだけが必要な調査用エージェントなら、代わりに6個だけを持たせます。
• 予算。 tool_costs で各ツールに価格を付け、spend_limit でチャットごとの上限を設定します。単位をリクエストにすると、Hermes は Sorsa API の呼び出しを数えます。上限を超えると、チャットでは呼び出しのたびに確認を求め、誰も答えられない cron ジョブでは、呼び出しを拒否します。cron の各実行は、ゼロから始まります。
• 信頼。 既定の trust: full のままにしてください。untrusted にすると、Hermes は読み取り専用と示されていないツールの前で必ず確認を求めますが、sorsa-mcp のツールにはまだその印が付いていないので、検索のたびに承認することになります。ツールは読み取りしかしないので、混乱した実行にかかるコストはせいぜいリクエスト分で、その分は予算で頭打ちになります。

仕事と予算を選んで、エントリをコピーしてください。

mcp_servers:
  sorsa:
    command: "npx"
    args: ["-y", "sorsa-mcp"]
    env:
      SORSA_API_KEY: "${SORSA_API_KEY}"
    supports_parallel_tool_calls: true
    tools:
      include:
        - search_tweets
        - search_users
        - get_user_info
        - get_user_info_batch
        - get_tweet_comments
        - get_key_usage_info
    tool_costs:
      search_tweets: 1
      search_users: 1
      get_user_info: 1
      get_user_info_batch: 1
      get_tweet_comments: 1
    spend_limit: 50
    cost_unit: requests

支出の上限が数えるのは、その会話で Hermes が承認した分であって、Sorsa API の請求額ではありません。Hermes を再起動すると、すべての合計がリセットされます。アカウントには独自の上限もあります。従量課金の追加リクエストは、ダッシュボードで選んだ期間の上限（初期値は$100）で停止します。

#Hermes にコードを書かせるなら、エージェント用スキルを追加する

Hermes なしで再実行できるプログラム、たとえば月次のエクスポート、メンションのアーカイブ、データベースへのフィードがほしいときは、Sorsa API のエージェント用スキルを使います。MCP ツールは結果をチャットに渡します。スキルは Hermes に、API の書かれたガイドを渡します。どの仕事にどのエンドポイントが合うか、next_cursor でどうページ送りするか、ID を100件ずつのバッチにする理由、そして小さな Python クライアントで、Hermes が書くスクリプトはそれを土台に仕上がります。

npx skills add Sorsa-io/sorsa-x-api-skill -g -a hermes-agent -y

11月2日にこの行を実行しました。sorsa-x-api スキルが、リファレンス、クライアントスクリプト、例とともに、Hermes がスキルを探す ~/.hermes/skills/ にコピーされます。エージェント名は hermes-agent で、-a hermes では「Invalid agents: hermes」で止まります。リクエストがスキルに合うまで、Hermes は1段落の要約だけを視界に置き、必要なときだけ SKILL.md を開くので、使っていないスキルはほとんどコンテキストを使いません（スキルのドキュメント（新しいタブで開きます））。

スキルのスクリプトは、SORSA_API_KEY からキーを読みます。Hermes は、名前に「KEY」を含む変数を execute_code 経由で実行する Python から遠ざけるので、config.yaml でこの変数だけは通してください。

terminal:
  env_passthrough:
    - SORSA_API_KEY

そのうえで、返答ではなくプログラムを頼みます。たとえば「過去1か月の [your product] についての X の投稿をすべて product_posts.csv に集める Python スクリプトを作って」と頼みます。Hermes は next_cursor が空で返ってくるまで POST /search-tweets（新しいタブで開きます） をページ送りし、スクリプトを1回実行して、次の実行に備えてそのまま残します。

#すぐ使える3つのプロンプトと、1回の実行コスト

以下のプロンプトはどれも、何を読むか、どれだけ読むか、何を返すかの3つを固定しています。そのためツール呼び出しも請求額も予測でき、プロンプトはターミナル、Hermes Desktop、ゲートウェイ経由の Telegram のチャットのどれでも、そのまま動きます。

トピックの概要をまとめてもらう

Search X for posts about [your topic] from the last 7 days
with at least 20 likes. Read the top 100, sort them into 3
to 5 themes, and send me a short brief with the 2 best
posts per theme, linked.

100件に届くまでに、Hermes は mcp_sorsa_search_tweets を5回呼び出し、next_cursor を渡していきます。1ページに約20件です。Sorsa API では、その概要のコストは$0.007から。x_search では同じ投稿でトークン料金の前に$0.50、公式 X API でも$0.50です。

1件の投稿への反応を読む

Read the first 200 replies to [post link], newest first.
Tell me what people praise, what they complain about and
what they ask, with 2 example replies for each.

Hermes は mcp_sorsa_get_tweet_comments を POST /comments（新しいタブで開きます） に対して10回呼び出します。1ページ20件の返信で、それぞれに投稿者のプロフィールが付きます。この実行は$0.014からです。公式 X API は同じ200件の返信に$1.00を課金し、各返信の投稿者への課金が始まれば最大$3.00になります。

アカウントのリストを審査する

Here are up to 100 X handles: [paste]. Get all the profiles
in one batch and make a table of followers, following,
posts, join date and bio, sorted by followers. Flag accounts
younger than one year and save it as accounts.csv.

mcp_sorsa_get_user_info_batch を1回呼び出すだけでリスト全体をカバーします。これは GET /info-batch（新しいタブで開きます） に対応し、1リクエストで最大100件のハンドルを受け取るので、この仕事は$0.0014からです。公式 X API はプロフィール1件$0.010で、リストなら$1.00。x_search もプロフィール1,000件あたり$10なので、同じく$1.00です。

3つのプロンプトを一通り実行すると16リクエストなので、無料の100回分で6回分を丸ごと賄えます。ボリュームが増えるほど差は開きます。毎日の概要や、混み合ったトピックの概要では、すぐに何十万件もの投稿を読むことになります。

#Hermes の cron で毎日の X ダイジェストを自分に送る

Hermes には独自のスケジューラがあるので、毎日の X ダイジェストはコマンド1つで済み、自分のサーバーは要りません。このジョブは、毎朝、ブランドについての直近1日分の投稿を読みます。

hermes cron create "every 1d at 08:00" \
  "Search X for posts about [your brand] from the last 24
  hours. Sort them into praise, complaints and questions,
  link the 3 most-liked posts in each, under 15 lines." \
  --name "X brand digest"

ターミナルから実行した場合、Hermes は各実行の結果を ~/.hermes/cron/output/ に保存します。スマートフォンで受け取るには、ゲートウェイ経由の Telegram のチャットで同じジョブを頼んでください（「毎朝8時に、…を送って」）。cron のドキュメント（新しいタブで開きます）にあるとおり、ダイジェストはそのチャットに返ってきます。

1日約100件の投稿なら、ダイジェストが読む投稿は月に3,000件です。コストは Sorsa API で月$0.21から、公式 X API では投稿者への課金の前で$15.00、x_search ではトークン料金を加えて$15.00です。sorsa エントリに spend_limit を設定すれば、各実行は許可したリクエスト数で止まるので、ニュースの多い日に請求額が膨らむことはありません。上のウィジェットにある監視用の設定が、この仕事に合います。

知っておきたいこと

投稿は Hermes が読むデータであり、その中の何も命令として扱うべきではありません。Hermes はすでに MCP の結果から見えない Unicode タグ文字を取り除いていますが、投稿の見える文章が、エージェントを誤った方向に導くように書かれていることはありえます。Sorsa API のツールはすべて読み取りだけなので、そうした投稿にできるのはせいぜいリクエストを1つ無駄にすることです。X を読む仕事には、不要なメッセージングツールやシェルツールを与えないでください。

#今日から Hermes Agent を X につなぐ

Hermes Agent 標準の X の経路は、X の価格で課金されます。x_search でも xurl でも、投稿1,000件あたり$5.00です。Hermes で X を読むなら、Sorsa API の MCP サーバーを使ってください。config.yaml のエントリ1つで読み取り専用ツール40個、ツイートは1,000件あたり$0.014から、Hermes が守るリクエスト予算があり、開発者アプリは不要です。Sorsa API が X のログイン情報を求めることはありません。100回分の無料リクエストで、上の3つのプロンプトを6回分実行できます。AI で開発には、貼り付けてすぐ使えるプロンプトがほかにもあります。ほかのエージェントもセットアップしますか？ Sorsa MCP サーバーのページに各クライアント向けの行があり、Twitter MCP サーバーガイドでは X サーバーの種類を比較しています。

#よくある質問