用途：Serply（https://serply.io）是一个 Google SERP API，返回关键词查询的排名自然结果，并把 Google News 和 Google Scholar 作为独立端点暴露。API 文档见 https://serply.io/docs。当“排名本身”就是答案时使用它，例如查询某关键词首页排名、某实体的带日期融资新闻、某论文的被引次数。概念相似度检索更适合 Exa，单一事实查证用普通 WebSearch 更省。
主要能力：search 端点返回有机结果，含 title、description、position、realPosition、result_type、link，以及 metadata.display_url；响应还可能有 answers、knowledge_graph、related_questions，仅在 Google 返回时填充。news 端点结果在 entries[]，含 title、link、published（RFC 1123）、summary、source.title，返回整个 feed 并忽略 num。scholar 端点结果在 articles[]，含 title、link、description、author.names、extras.citations.count（如 "Cited by 269516"），有 PDF 时 doc.link 指向它。
使用方式：先取密钥，可用 mcp__agent-swarm__get-config(key="SERPLY_API_KEY", includeSecrets=true)，值在 configs[0].value，密钥来自 https://serply.io。请求头用 X-Api-Key 携带裸密钥，不是 Authorization: Bearer。示例：curl -sS 'https://api.serply.io/v1/search/?q=bun+sqlite+orm&num=10' -H "X-Api-Key: $SERPLY_API_KEY" -H 'User-Agent: agent-swarm/1.0'。参数在查询串：q 必填，为 URL 编码关键词而非自然语言描述，Google 操作符可直接透传，如 q=sqlite+site%3Abun.sh，tbs 日期过滤同样生效；num 最多 10 并被截断，需要更多请翻页。news 与 scholar 同主机同请求头，仅路径与响应键不同。
限制与注意：Serply 位于 Cloudflare 之后，默认库 User-Agent 会被拒，Python urllib 会得到 HTTP 403 与 error code: 1010，需显式发送 User-Agent，curl 默认值可接受。/v1/scholar/ 同时返回 articles 和空的 results: []，应读 articles，读 results 会得到零篇且响应不说明原因。排名依赖地区，不同区域两次运行可能合理不一致，若位置是关键应连同查询一起记录。结果行只给标题、摘要和排名，要引用内容需再用 WebFetch 抓取页面。查询无相关结果时应写“not surfaced”，不要编造链接。