Communitygithub.com

sasakiblog26-lgtm/exa-mcp-server

使用 Exa 高级搜索功能搜索个人网站和博客。完全支持过滤参数,可用于查找个人观点、作品集和个人博客。在搜索个人网站、博文或作品集时使用。

exa-mcp-server 是什么?

该技能提供了一个基于 Exa 高级搜索的专用工具 `web_search_advanced_exa`,并强制限定搜索类别为“personal site”(个人网站)。它支持所有可用的搜索参数,包括核心查询、域名包含/排除、ISO 8601 日期过滤、文本包含/排除、内容提取(摘要、高亮)以及子页面探索等高级功能。特别地,它限制了 `includeText` 和 `excludeText` 数组只能为单元素数组,以避免 400 错误;若需匹配多个词条,建议将词条放入 `query` 字符串或分别运行搜索。该技能强调“Token 隔离”:绝不能在主上下文中执行 Exa 搜索,而应始终派生子任务 Agent 来执行搜索、合并去重结果,并返回精简后的输出(Markdown 或紧凑 JSON),从而保持主上下文的清洁。适用于需要获取个人专家观点、技术博客、作品集和独立分析的场景。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sasakiblog26-lgtm/exa-mcp-server/tree/HEAD/skills/personal-site-search

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Web 高级搜索 - 个人网站分类

工具限制(关键)

仅使用 web_search_advanced_exa 并设置 category: "personal site"。不要使用其他分类或工具。

全面过滤支持

personal site 分类支持所有可用参数:

核心

  • query(必需)
  • numResults
  • type("auto", "fast", "deep", "neural")

域名过滤

  • includeDomains
  • excludeDomains(例如,排除 Medium 以获取独立博客)

日期过滤(ISO 8601)

  • startPublishedDate / endPublishedDate
  • startCrawlDate / endCrawlDate

文本过滤

  • includeText(必须包含所有)
  • excludeText(如果匹配任意则排除)

数组大小限制: includeText 和 excludeText 仅支持单元素数组。多元素数组(2 个及以上)会导致 400 错误。若要匹配多个词条,请将它们放入 query 字符串中,或分别运行搜索。

内容提取

  • textMaxCharacters / contextMaxCharacters
  • enableSummary / summaryQuery
  • enableHighlights / highlightsNumSentences / highlightsPerUrl / highlightsQuery

附加功能

  • additionalQueries
  • maxAgeHours / livecrawlTimeout
  • subpages / subpageTarget - 适用于探索作品集网站

Token 隔离(关键)

绝不在主上下文中运行 Exa 搜索。始终派生子任务 Agent:

  • Agent 使用 category: "personal site" 调用 web_search_advanced_exa
  • Agent 在呈现结果之前进行合并与去重
  • Agent 返回精简后的输出(简短的 Markdown 或紧凑 JSON)
  • 无论搜索量多大,主上下文始终保持清洁

使用时机

在需要以下内容时使用此分类:

  • 个人专家观点与经验
  • 关于技术话题的个人博文
  • 作品集网站
  • 独立分析(而非企业内容)
  • 来自实践者的深度文章与教程

示例

技术博客文章:

web_search_advanced_exa {
  "query": "building production LLM applications lessons learned",
  "category": "personal site",
  "numResults": 15,
  "type": "deep",
  "enableSummary": true
}

关于某话题的最新文章:

web_search_advanced_exa {
  "query": "Rust async runtime comparison",
  "category": "personal site",
  "startPublishedDate": "2025-01-01",
  "numResults": 10,
  "type": "auto"
}

排除聚合平台:

web_search_advanced_exa {
  "query": "startup founder lessons",
  "category": "personal site",
  "excludeDomains": ["medium.com", "substack.com"],
  "numResults": 15,
  "type": "auto"
}

输出格式

返回:

  1. 结果(标题、作者/网站名称、日期、关键见解)
  2. 来源(URL)
  3. 备注(作者专业性、潜在偏见、覆盖深度)

相关技能