Atodeyomu

X (Twitter) で「あとで読む」目的の 引用リツイート（引用ポスト） を検出する、読み取り専用の MCP サーバーです。引用ポストとその引用元（本文・メディア・著者）をまとめて取得し、Claude（Cowork）→ Notion の知識管理パイプラインから利用することを想定しています。

提供するツールは get_quoted_posts（前回以降の引用ポストを取得）・commit_cursor（取得位置を確定）・fetch_article（引用元が貼った記事 URL を解決して本文を抽出）の 3 つです。X への投稿・いいね・RT などの書き込みは一切行いません（fetch_article も記事の読み取りのみ）。前回どこまで取得したかはローカル（~/.atodeyomu-mcp/cursor.json）に記録し、since_id で差分だけを取得するため、Notion 照合のコストを抑えられます。

動作確認の詳細手順は docs/VERIFICATION.md、Cowork スケジュールタスクで Notion に記録するまでの手順は docs/COWORK_PIPELINE.md を参照してください。設計の詳細は docs/DESIGN.md、フロー図つきの仕様は docs/SPEC.md にあります。

必要なもの

• Node.js 20 以上（npx が使えること）
• X Developer アカウント（無料プランで可）
• Claude（Cowork / デスクトップアプリ）

npx で実行するため、リポジトリの clone やビルドは不要です。

セットアップ

1. X Developer Portal でアプリを作成

1. developer.x.com でプロジェクトとアプリを作成します。
2. アプリの User authentication settings を開き、次のように設定します。
   • App permissions: Read
   • Type of App: Web App, Automated App or Bot（Confidential client）
   • Callback URI / Redirect URL: http://127.0.0.1:8787/callback
   • Website URL: 任意の URL（例: GitHub リポジトリ URL）
3. Keys and tokens から OAuth 2.0 Client ID と Client Secret を控えます。

スコープは tweet.read users.read offline.access の 3 つだけを使います。

2. 認可（初回のみ）

トークンを取得する認可を一度だけ実行します。控えた Client ID / Secret をフラグで渡します。

npx -y atodeyomu-mcp auth --client-id 控えたClientID --client-secret 控えたClientSecret

1. ターミナルに表示された認可 URL をブラウザで開きます。
2. X で承認すると http://127.0.0.1:8787/callback にリダイレクトされ、access / refresh token を取得します。
3. トークンは ~/.atodeyomu-mcp/tokens.json に chmod 600 で保存されます。

以降、トークンは MCP サーバーが自動でリフレッシュします。再認可が必要になるのは refresh token が失効したときだけです（その場合は同じコマンドを再実行）。

3. MCP クライアントへの登録

Claude（Cowork / デスクトップアプリ）の MCP 設定ファイルに登録します。場所は次のとおりです。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

このファイルの mcpServers に次を追記します（他のキーは消さないこと）。CLIENT_ID / CLIENT_SECRET は env で渡します（サーバーがトークンを自動リフレッシュする際に必要です）。

{
  "mcpServers": {
    "atodeyomu": {
      "command": "npx",
      "args": ["-y", "atodeyomu-mcp@latest"],
      "env": {
        "CLIENT_ID": "控えたClientID",
        "CLIENT_SECRET": "控えたClientSecret"
      }
    }
  }
}

保存後、Claude（Cowork）アプリを再起動すると atodeyomu が接続されます。

@latest を付けると、アプリ再起動のたびに最新版を取得します（npx はキャッシュするため、付けないと古い版を使い続けます）。バージョンを固定したい場合は [email protected] のように指定してください。

いま動いている版は npx -y atodeyomu-mcp --version、npm 上の最新版は npm view atodeyomu-mcp version で確認できます。

この MCP 設定ファイルには秘密情報（Client ID / Secret）が平文で入ります。共有・コミットしないでください。

Claude Code CLI など他の MCP クライアントを使う場合は、上の atodeyomu エントリ（command / args / env）を各クライアントの MCP 設定に記述してください（中身は同じです）。

使い方

登録後、Claude（Cowork）から 3 つのツールを呼び出せます。基本の流れは「get_quoted_posts で差分を取得 →（引用元に記事 URL があれば fetch_article で本文を取得）→ 要約して Notion に保存 → 成功したら commit_cursor で取得位置を確定」です。

get_quoted_posts

前回確定した位置以降の引用ポストを返します。この時点では取得位置を進めません。

入力

パラメータ	型	必須	デフォルト	説明
limit	number	任意	なし	1〜50。指定すると 古い順（id 昇順）に最大 N 件だけ返る（MCP が内部で全ページを取得して絞り込む）。max_results / pagination_token とは併用しない
max_results	number	任意	20	1〜100（limit を指定しない従来モードで有効）
since_id	string	任意	カーソル値	取りこぼし時に取得開始位置を手動で巻き戻すための上書き
pagination_token	string	任意	なし	前回のレスポンスの next_token。差分が max_results を超える場合、これを渡して呼び直すと続きのページを取得できる（limit を指定しない従来モードで有効）

出力（例）

{
  "posts": [
    {
      "id": "1899...",
      "text": "これあとで読む",
      "created_at": "2026-06-20T09:12:00.000Z",
      "url": "https://x.com/your_name/status/1899...",
      "quoted_post": {
        "id": "1898...",
        "text": "引用元の本文 ...",
        "created_at": "2026-06-19T22:00:00.000Z",
        "author_username": "someone",
        "url": "https://x.com/someone/status/1898...",
        "media": [{ "url": "https://pbs.twimg.com/media/xxx.jpg", "type": "photo" }]
      }
    }
  ],
  "newest_seen_id": "1899...",
  "next_token": null,
  "has_more": false
}

前回以降の直近 max_results 件のうち、引用ポストだけが posts に返ります。「あとで読む」というキーワードでの絞り込みや要約は、呼び出し側（Cowork のスキル/タスク）で行う設計です。has_more は「返した分の先にまだ未処理の引用ポストが残っているか」を示します。

limit を指定すると、MCP が内部で全ページを取得したうえで引用ポストを古い順（id 昇順）に並べ、先頭 N 件だけを返します。差分が溜まっていても、呼び出し側は 1 回呼ぶだけで「処理すべき古い N 件」と has_more を受け取れます（差分全件をコンテキストに載せずに済む）。想定フローは、古い順に処理してから commit_cursor を呼ぶこと——全件処理でき has_more が false なら newest_seen_id で、has_more が true なら返ってきた posts の最後（最も新しい）の id で確定し、残りは次回に回します。

limit を指定しない従来モードでは単一ページが返り、next_token が値を持つ場合はまだ続きがあるということなので、その値を pagination_token に渡して呼び直すとページ送りできます。全ページ分の posts を合算し、commit_cursor には1回目（pagination_token を指定しない呼び出し）の newest_seen_id を渡します（2回目以降は過去方向へのページ送りのため、より新しい id を含みません）。

fetch_article

引用元ポストが貼っている記事 URL を解決し、リンク先の本文テキストを抽出して返します。quoted_post.text に含まれる t.co 短縮 URL をそのまま渡せば、MCP がリダイレクトを追って最終記事 URL に解決し、本文を取り出します。返すのは抽出済み本文までで、要約は呼び出し側で行います。

入力

パラメータ	型	必須	説明
url	string	必須	記事の URL。quoted_post.text の t.co 短縮 URL や記事 URL をそのまま渡してよい

出力（例）

{
  "final_url": "https://zenn.dev/someone/articles/xxxx",
  "title": "記事タイトル",
  "text": "抽出された記事本文 ...",
  "status": "ok"
}

status は結果の種別です。ok 以外のときは text が空文字になります。

status	意味
ok	記事本文を抽出できた（text に本文が入る）
x_post	リダイレクト先が X の別ポストだった（引用元がさらに別ポストを引用しているケース）。本文は取得しない
x_article	リダイレクト先が X ネイティブ記事（x.com/i/article/…）だった。認証必須のため本文は取得できない
not_article	取得できたが記事本文として抽出できなかった（画像・動画のみ、非 HTML 等）
fetch_failed	ネットワークエラー・非 HTTP・ペイウォール・タイムアウト等

ok 以外は「記事が取れなかった」だけでエラーではありません。呼び出し側は引用コメントと引用元本文からの要約にフォールバックする想定です。記事の読み取り（GET）のみで、X や外部サイトへの書き込みは行いません。

commit_cursor

Notion への保存が成功したあとに呼び、取得位置を進めます。

パラメータ	型	必須	説明
post_id	string	必須	ここまで安全に保存できた最後の post id

全件成功なら get_quoted_posts が返した newest_seen_id を、一部だけ保存できた場合はその最後の id を渡します。次回の get_quoted_posts はその id 以降から再開します。途中で失敗して commit_cursor を呼ばなければ取得位置は据え置かれ、次回また同じ差分を取り直せるので取りこぼしが起きません。

動作確認

1. X 上で、適当な投稿に「あとで読む」とコメントを付けて 引用ポスト します。
2. 上記の MCP 設定に登録した状態で Claude（Cowork）アプリを起動します。
3. Claude（Cowork）に get_quoted_posts を呼ぶよう指示します（例:「直近の引用ポストを取得して」）。
4. 手順 1 の引用ポストが、引用元の本文・メディアまで含めて返ってくれば成功です。
5. 続けて、返ってきた newest_seen_id で commit_cursor を呼び、~/.atodeyomu-mcp/cursor.json が更新されることを確認します。次回 get_quoted_posts を呼ぶと、その位置以降の差分だけが返ります。

トラブルシューティング

症状	対処
認可を再実行してください と出る	refresh token が失効しています。npx -y atodeyomu-mcp auth --client-id <ID> --client-secret <SECRET> をやり直してください。
トークン期限切れ後にリフレッシュで失敗する	MCP 設定ファイル（claude_desktop_config.json）の env に CLIENT_ID / CLIENT_SECRET が設定されているか確認してください。
レート制限のエラー	メッセージ中の Retry-After（秒）だけ待ってから再試行してください。
コールバックが届かない	Developer Portal の Callback URI が http://127.0.0.1:8787/callback と完全一致しているか確認してください。

セキュリティ

• Client ID / Secret は MCP 設定ファイル（claude_desktop_config.json）の env に平文で入ります。この設定ファイルとトークン（~/.atodeyomu-mcp/tokens.json）は秘密情報です。コミット・共有しないでください。
• 資格情報（Client ID / Secret）は、サーバー起動時は MCP 設定ファイルの env、認可時は --client-id / --client-secret フラグで渡します。
• トークンファイルは chmod 600 で保存されます。
• カーソル（~/.atodeyomu-mcp/cursor.json）は秘密情報ではありませんが、トークンと同じディレクトリで管理されます。取得位置をリセットしたい場合はこのファイルを削除してください。次回呼び出しは since_id なしになるため、まずタイムラインの直近 max_results 件（既定20・最大100）が返りますが、レスポンスの next_token を pagination_token に渡して呼び直せば、それより古い投稿も複数回のページ送りで遡って取得できます。
• 本サーバーは X に対して読み取り専用で、書き込み権限は要求しません（ローカルのカーソルファイルのみ書き込みます）。

免責

This project is unofficial, community-maintained, and not affiliated with X Corp. Use at your own risk. "X" and "Twitter" are trademarks of their respective owners.