MCP

🚀 PostCrawl MCP Server

PostCrawl MCP Serverは、Cloudflare WorkersベースのModel Context Protocol (MCP)サーバーです。このサーバーを通じて、特にRedditを含むソーシャルメディアプラットフォームからコンテンツを検索および抽出するためのPostCrawl APIにアクセスできます。

🚀 クイックスタート

前提条件

• Node.js (最新のLTSバージョン)
• Bun (推奨) またはnpm
• Cloudflareアカウント (デプロイ用)
• PostCrawl APIキー
• MCP Inspector (テスト用)

インストール

1. 依存関係をインストールします：

npm install

2. 開発サーバーを起動します：

bun dev

3. サーバーは http://localhost:8787 で利用可能になります。

MCP Inspectorを使用したテスト

このMCPサーバーをテストする最も簡単な方法は、MCP Inspectorを使用することです。

📖 詳細な手順とスクリーンショット付きの説明は、how-to-use.md を参照してください。

概要：

1. MCP Inspectorをインストールします：npx @modelcontextprotocol/inspector
2. "Streamable HTTP" トランスポートタイプを使用します。
3. https://postcrawl.com/mcp に接続します。
4. PostCrawl APIキーを使用してAuthorizationヘッダーを追加します。
5. 利用可能なツールをテストします。

✨ 主な機能

PostCrawlは、ソーシャルメディアプラットフォーム全体の投稿を検索し、そのコンテンツを抽出することができるAPIサービスです。このMCPサーバーは、PostCrawl APIへのシームレスなインターフェースを提供し、AIアシスタントが以下のことを可能にします：

• カスタマイズ可能なパラメータで投稿を検索する
• 特定のURLからコンテンツを抽出する
• Markdown形式で投稿を取得する
• 簡略化されたブールパラメータで抽出深度を制御する
• APIのヘルスステータスを確認する

📦 インストール

上述の通り、依存関係のインストールと開発サーバーの起動手順があります。

💻 使用例

基本的な使用法

以下は、PostCrawl APIを使用して投稿を検索する基本的なコード例です。

# 依存関係のインストール
npm install
# 開発サーバーの起動
bun dev

高度な使用法

search_and_extract を使用して、投稿を検索しながらコンテンツを抽出する例です。

# 適切なパラメータを設定してAPIにリクエストを送信する
# 具体的なコードは省略

📚 ドキュメント

認証

サーバーは、Bearerトークンとして提供されるPostCrawl APIキーを必要とします：

Authorization: Bearer YOUR_POSTCRAWL_API_KEY

利用可能なMCPツール

1. search

ソーシャルメディアプラットフォーム全体で投稿を検索します。

パラメータ:

• query (文字列、必須): 検索クエリ
• page (整数、オプション): ページ番号 (デフォルト: 1)
• results (整数、オプション): 結果の数 (デフォルト: 10)
• social_platforms (文字列配列、オプション): 検索するソーシャルプラットフォーム

2. search_and_extract

投稿を検索し、そのコンテンツを1つの操作で抽出します。

search と同じパラメータに加えて、以下が追加されます：

• response_mode (文字列、オプション): レスポンス形式 - "raw" または "markdown" (デフォルト: "raw")
• include_comments (ブール値、オプション): コメントと返信を含める (デフォルト: false)

3. extract

特定のURLからコンテンツを抽出します。

パラメータ:

• urls (文字列配列、必須): コンテンツを抽出するURLのリスト
• include_comments (ブール値、オプション): コメントと返信を含める (デフォルト: false)
• response_mode (文字列、オプション): レスポンス形式 - "raw" または "markdown" (デフォルト: "raw")

4. check_health

PostCrawl APIのヘルスステータスを確認します。

パラメータ: なし

開発スクリプト

• bun dev または npm run dev - 開発サーバーを起動します
• npm run deploy - Cloudflare Workersにデプロイします
• npm run type-check - TypeScriptの型チェックを実行します
• npm run cf-typegen - Cloudflare Workerの型を生成します

デプロイ

Cloudflare Workersにデプロイするには、以下のコマンドを実行します：

npm run deploy

設定

PostCrawl APIの設定：

レート制限

レート制限は、あなたのPostCrawl APIプランに依存します。サーバーは、レート制限のレスポンスに対して適切なエラーハンドリングを行います。

アーキテクチャ

• Hono: Cloudflare Workers用のWebフレームワーク
• agents/mcp: MCPエージェントフレームワーク
• @modelcontextprotocol/sdk: MCPプロトコルの実装
• zod: ランタイム型検証
• PostCrawl API: ソーシャルメディアコンテンツ抽出サービス

エラーハンドリング

サーバーは、以下のエラーに対して包括的なエラーハンドリングを提供します：

• 認証の欠如または無効
• PostCrawl APIエラー
• 無効なリクエストパラメータ
• ネットワークタイムアウト

📄 ライセンス

このプロジェクトは、ISCライセンスの下でライセンスされています。