Reddit Archive

@pipeworx/reddit-archive

Reddit 初期まで遡る、過去の Reddit 投稿とコメントの検索、およびサブレディットの活動状況の推移を確認できます。最近の未加工データしか公開していない Reddit のライブ API より、はるかに古いデータまで遡れます。

Pipeworx の一部です。AI エージェントを 1779 以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携しておらず、承認も公開も受けていません。

ツール

• reddit_history_posts(subreddit, query?, after?, before?, limit?, sort?) — 1 つのサブレディットの投稿を、キーワードや日付範囲で絞り込みます。id、title、author、created_utc（ISO）、score、num_comments、permalink を返します。
• reddit_history_comments(subreddit?, link_id?, query?, after?, before?, limit?, sort?) — サブレディットや特定の投稿を対象に、キーワードや日付範囲でコメントを絞り込みます。subreddit または link_id の少なくとも一方が必要です。id、author、created_utc（ISO）、score、body、link_id、permalink を返します。
• subreddit_activity(subreddit, after?, before?) — サブレディットの情報（登録者数、作成日、累計投稿数／コメント数、インデックスに記録された最古の投稿／コメント）と、日付範囲内の月ごとの投稿数／コメント数（デフォルト：過去 12 か月）を返します。

認証

キー不要です。

データソース

• Arctic Shift（Arthur Heitmann によるオープンソースプロジェクト arctic_shift）。過去の Reddit アーカイブです。公開されている Reddit の投稿、コメント、サブレディットのメタデータを独自に再クロールして再公開しており、Reddit のライブ API では提供されなくなった過去のデータを含みます。稼働時間の保証は公開されていません。

その他の注意事項

• 該当なしの判定。 上流は、該当する結果が空の場合、サブレディットにフィルター条件に一致するデータが本当にない場合も、サブレディットが一度もインデックスに登録されていない場合も、同じ形式で応答します。この場合に専用の「見つかりません」ステータスはありません。結果が空の場合、このパックは上流独自のサブレディットインデックスに追加で 1 回問い合わせ、両者を区別します。インデックス未登録または存在しないサブレディットの場合は明確なエラーを返し、実在するサブレディットで該当期間の結果が本当に空の場合は、単なる [] ではなく verified_empty: true を明示した結果を返します。reddit_history_comments では、subreddit ではなく link_id で投稿を指定した場合、投稿 ID に対して同じ確認を行います。
• 一時的な 422 および 429。 上流は、正しい形式のクエリに対して HTTP 422（「タイムアウトしました。少し時間をおいてください」）または HTTP 429（レート制限）を返すことがあります。実際の稼働中に、クエリ自体とは無関係に、負荷がかかると 2～3 回連続で発生することが確認されています。このパックは両方のエラーを再試行します。上流から 429 に対して Retry-After が送られた場合はそれを尊重し、固定の試行回数ではなく、最大 20 秒の実時間の再試行予算内で再試行してから、実際のエラーとして返します。
• 月次バケットのラベル付け（subreddit_activity）。 上流の集計エンドポイントは現地時間の暦月でバケットを分けますが、各バケットのタイムスタンプは UTC に変換されるため、UTC では前日の最終時刻になります（例：1 月のバケットは "2019-12-31T23:00:00.000Z" として届きます）。このパックは月を読み取る前にタイムスタンプを次の UTC の午前 0 時まで進めるため、monthly_posts／monthly_comments には実際の対象月がラベルとして付けられます。
• 負荷への配慮。 このパックは、外部への呼び出しをおよそ 1 秒に 1 回に抑えます。上流への呼び出しが内部で複数回必要なツール（空の結果に対する存在確認、subreddit_activity の 3 回の呼び出し）は、立て続けに実行せず、間隔を空けて呼び出します。
• 投稿者ごとの集計なし。 reddit_history_comments は投稿者によるフィルターを受け付けません。また、このパックはどのツールの結果も投稿者ごとに集計せず、フィルターに一致した公開済みの投稿／コメントをそのまま返します。
• 日付形式。 after／before には "2019-01-01" のような ISO 形式の日付を指定します。
• ID はプレフィックスなしで返されます（例："t3_ei9204" ではなく "ei9204"）。link_id にはどちらの形式も指定できます。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "reddit-archive": {
      "url": "https://gateway.pipeworx.io/reddit-archive/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/reddit-archive/mcp の tools/list は、上の表にあるツールに加えて、共有の Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールとともに、約30個の共有ツールが一覧表示されます。接続の initialize 応答には正確な対象範囲が記載されており、その日の時点での正式な情報です。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うと、このパックでは扱えない質問にも、カタログ全体を横断して振り分ける ask_pipeworx を通じて回答できます。そのため、2つ目の MCP サーバーを追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマによって増えるコンテキストコストが、振り分けのメリットを上回る場合は、複数のパックエンドポイントではなく、完全版ゲートウェイに一度だけ接続してください。

または、完全版の Pipeworx ゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1779 以上のデータソースにつながります。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使えばすべてのツールにアクセスできます。

MCP クライアントをお持ちでない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/reddit_history_posts \
  -H 'Content-Type: application/json' \
  -d '{"subreddit":"datasets","before":"2020-01-01","after":"2019-01-01","limit":5}'

最初の呼び出しにアカウントは不要です。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/reddit_history_posts を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントもゲートウェイとの往復通信も必要ありません。

{
  "mcpServers": {
    "reddit-archive": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-reddit-archive"]
    }
  }
}

または、直接実行して起動することを確認できます。

npx -y @pipeworx/mcp-reddit-archive

stdin/stdout 経由で MCP 通信を行い、initialize／tools/list／tools/call に対して、このパックのツールのみで応答します。上記のゲートウェイ接続で追加される共有メタツールはありません。同じソース、同じツールで、ask_pipeworx による振り分けはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは、上記のパックエンドポイントでも完全版ゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Reddit Archive data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT