MCP

🚀 PostCrawl MCP 服務器

PostCrawl MCP 服務器是一個基於 Cloudflare Workers 的模型上下文協議（MCP）服務器，它提供對 PostCrawl API 的訪問，可用於在社交媒體平臺（尤其是 Reddit）上搜索和提取內容。

🚀 快速開始

前提條件

• Node.js（最新的 LTS 版本）
• Bun（推薦）或 npm
• 一個 Cloudflare 賬戶（用於部署）
• PostCrawl API 密鑰
• MCP 檢查器（用於測試）

安裝

1. 安裝依賴項：

npm install

2. 啟動開發服務器：

bun dev

3. 服務器將在 http://localhost:8787 上可用。

使用 MCP 檢查器進行測試

測試此 MCP 服務器的最簡單方法是使用 MCP 檢查器。

📖 請參閱 how-to-use.md 以獲取帶有截圖的詳細分步說明。

快速概覽：

1. 安裝 MCP 檢查器：npx @modelcontextprotocol/inspector
2. 使用 "Streamable HTTP" 傳輸類型
3. 連接到：https://postcrawl.com/mcp
4. 添加帶有 PostCrawl API 密鑰的授權頭
5. 測試可用工具

✨ 主要特性

PostCrawl 是一個 API 服務，允許你在社交媒體平臺上搜索帖子並提取其內容。此 MCP 服務器為 PostCrawl API 提供了無縫接口，使 AI 助手能夠：

• 使用可定製的參數搜索帖子
• 從特定 URL 提取內容
• 以 Markdown 格式檢索帖子
• 使用簡化的布爾參數控制提取深度
• 檢查 API 健康狀態

📦 安裝指南

前提條件

• Node.js（最新的 LTS 版本）
• Bun（推薦）或 npm
• 一個 Cloudflare 賬戶（用於部署）
• PostCrawl API 密鑰
• MCP 檢查器（用於測試）

安裝步驟

1. 安裝依賴項：

npm install

2. 啟動開發服務器：

bun dev

3. 服務器將在 http://localhost:8787 上可用。

💻 使用示例

基礎用法

使用 search 工具搜索帖子：

# 假設已經設置好授權頭
curl -X POST -H "Authorization: Bearer YOUR_POSTCRAWL_API_KEY" -d '{"query": "example query"}' https://postcrawl.com/mcp/search

高級用法

使用 search_and_extract 工具搜索並提取帖子內容，以 Markdown 格式返回幷包含評論：

curl -X POST -H "Authorization: Bearer YOUR_POSTCRAWL_API_KEY" -d '{"query": "example query", "response_mode": "markdown", "include_comments": true}' https://postcrawl.com/mcp/search_and_extract

📚 詳細文檔

認證

服務器需要將 PostCrawl API 密鑰作為 Bearer 令牌提供：

Authorization: Bearer YOUR_POSTCRAWL_API_KEY

可用的 MCP 工具

1. search

在社交媒體平臺上搜索帖子。 參數：

• query（字符串，必需）：搜索查詢
• page（整數，可選）：頁碼（默認值：1）
• results（整數，可選）：結果數量（默認值：10）
• social_platforms（字符串數組，可選）：要搜索的社交媒體平臺

2. search_and_extract

在一次操作中搜索帖子並提取其內容。 與 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 許可證。