用途
idapixl-web-research-mcp 是一个 MCP（Model Context Protocol）服务器，专为需要联网搜索、阅读网页并综合研究结果的 AI 智能体设计。它把搜索、抓取和综合研究整合到单次工具调用中，让 AI 智能体能够完成从检索到信息提炼的完整流程。
主要能力
该服务器提供三个协同工作的工具：
- web_search：执行网页搜索。参数包括 query（必填，搜索查询，最多 500 字符）、maxResults（可选，1–10，默认 5）、freshness（可选，时效过滤：pd 过去一天、pw 过去一周、pm 过去一月、py 过去一年，仅 Brave 支持）。
- fetch_page：抓取并读取页面，转换为干净的 Markdown。参数包括 url（必填，页面 URL）、timeoutSecs（可选，5–120，默认 30）、extractMode（可选，article 提取正文主要内容（默认）、full 提取整个 body、links 提取所有链接）。
- research_topic：执行多步骤深度研究。参数包括 topic（必填，研究主题或问题，最多 500 字符）、maxSources（可选，1–5，默认 3）、focus（可选，用于缩小研究范围的子问题，如“性能基准”，最多 200 字符）。该工具会对来源进行相关性评分，去重近似重复来源（过滤句子重叠超过 70% 的内容），并提取包含查询词的关键句子。
使用方式
将服务器添加到 MCP 客户端配置中（如 Claude Desktop、Cursor 等），并替换 YOUR_APIFY_API_TOKEN 为来自 apify.com/account/integrations 的令牌。对于 Cursor / Windsurf，可通过 Settings > MCP Servers > HTTP URL 添加。
Brave Search API 设置（可选但推荐）：默认情况下使用 DuckDuckGo HTML 抓取，无需任何密钥即可工作。若需更好的结果和时效过滤，可前往 brave.com/search/api 注册免费层（每月 2,000 次查询），复制 API 密钥，并在 actor 输入中设置 Brave Search API Key（作为密钥存储，不会暴露在日志中）。设置密钥后，web_search 和 research_topic 将自动使用 Brave Search，出错时回退到 DuckDuckGo。
适用场景
适用于需要 AI 智能体进行联网信息检索、网页内容读取与多来源综合研究的场景，例如资料收集、事实核查、竞品调研等。支持 Claude Desktop、Cursor、Windsurf 等 MCP 客户端。
限制与计费
- 按使用量付费，仅按工具调用收费，无订阅、无闲置费用。
- 费用在执行前扣除；如果页面在扣费后加载失败，工具会返回错误。
- 无状态：每个 MCP 请求获得隔离的服务器实例。
- 使用 Apify Residential 代理可提高对阻止数据中心 IP 的页面的成功率。
- 技术栈：TypeScript、MCP SDK 1.x、Apify SDK 3.x。
- 由 Idapixl 构建。
