Search1API文档

更新日志

Search1API 的兼容性承诺,以及 API、SDK、CLI 和 MCP 服务器按日期记录的变更。

本页记录所有开发者接口的变更:HTTP API 契约(端点、请求与响应字段、状态码、请求头、计费规则)、官方 SDK、CLI 和 MCP 服务器。每条记录都标注了其影响的范围。产品和仪表盘更新见产品更新日志。

当前版本

类型包版本发布日期
TypeScript SDK@search1api/client0.4.02026-10-12
Vercel AI SDK 工具@search1api/ai-sdk0.3.02026-10-12
Python SDKsearch1api0.4.02026-10-12
CLIsearch1api-cli2.0.02026-10-12
MCP 服务器search1api-mcp0.8.02026-10-14
LangChainsearch1api-langchain0.2.02026-10-12
n8nn8n-nodes-search1api0.2.02026-10-12
DeepSeek Harnessdsh-s10.2.02026-10-12
Hermeshermes-search1api0.2.02026-10-12
OpenCodeopencode-search1api0.2.02026-10-12
OpenClawopenclaw-search1api0.2.02026-10-12
Grok Buildgrok-search1api1.0.02026-08-04
Factory Droiddroid-s1无版本号2026-08-16

HTTP API 没有版本号。变更通常是新增性的;明确的兼容性例外会记录在下方。

兼容性承诺

Search1API 不在 API URL 中区分版本。默认的兼容性规则如下:

  • 新增性变更不另行通知。 新端点、新的可选请求字段、新的响应字段、新的枚举值和新的响应头可能随时出现。请忽略无法识别的响应字段。
  • 未知的请求字段会被忽略。 发送 API 已不再读取的字段不会导致请求失败。
  • 现有字段保持名称、类型和位置不变。 下方 2026-10-12 的元数据修正是针对近期新增的引擎特有字段的一次性例外;默认规则仍是不对现有字段重命名、更改类型或移动位置。
  • 移除会先在此公告。 当某个端点或字段必须移除时,本页和产品更新日志会在变更上线前公告。已移除的端点会继续以 410 Gone 响应,并在消息中注明替代方案。
  • 状态码属于契约的一部分。 状态码含义的变化(例如零结果搜索从 404 改为 200)会连同上线日期记录在下方。

机器可读的契约是 OpenAPI 文档。官方 SDK、CLI 和 MCP 服务器均基于该契约构建,会在下一次发布时纳入新增性变更;它们各自的发布遵循语义化版本,并与 API 变更一起列在本页。

新的请求字段使用 snake_case(max_results、crawl_results、timeout_ms)。少数较早的字段使用 camelCase(enableFallback、taskId、zipUrl),并将保持不变;在有帮助的情况下,API 会在原字段之外同时接受一个 snake_case 别名。

变更记录

标签:API(HTTP 契约)、SDK(TypeScript 和 Python 客户端)、CLI(s1)、MCP(托管与 stdio 服务器)、Integrations(框架与智能体插件)、Docs(文档)。

2026-10-22

  • Website:新增 SearXNG、Google CSE 和 Bing v7 专属迁移指南,提供英文、中文和日文版本。兼容 API 页面现在把迁移指南与引擎产品页、技术参考分开链接。

  • API:新增 Google Custom Search JSON API 兼容端点,在 Google 2027 年 1 月 1 日迁移截止日期之前提供首页网页搜索。只需更换端点和密钥,即可继续使用受支持的 cse().list() 调用和 items 解析。cx 不会导入 Google 配置;分页、图片搜索和 SafeSearch 明确不支持。请求与原生接口共用认证、速率限制和搜索计费。

  • API:兼容端点在 https://api.search1api.com/compat/{api} 下响应另外七种搜索 API 的请求与响应格式:SearXNG、Tavily(/search、/extract)、Exa(/search、/contents)、Firecrawl(/v1 和 /v2 的 /scrape 与 /search)、Jina Reader 与 Search、Bing Web Search v7(网页、新闻和图片搜索)以及 Brave Search(网页、新闻和图片搜索)。现有客户端只需更换基础 URL 并使用 Search1API 密钥即可切换。请求按等效的 /search、/news 或 /crawl 请求计费和限速;搜索时读取页面内容,每个页面消耗 1 积分。不支持的选项会被忽略,没有对应项的字段返回空值。参见兼容 API。

  • Docs:兼容 API 新增概览页,并为每个 API 提供一页说明,涵盖客户端配置、参数映射、响应差异、积分和错误格式。官网也有兼容 API 页面。

2026-10-14

  • MCP:search1api-mcp 0.8.0 在远程 HTTP 和本地 stdio 中新增 render_results。模型可以在 MCP Apps 客户端中把选定的已有来源显示为交互式卡片;所有客户端也都会收到结构化 JSON 和完整的文本列表。渲染和展开来源不会重复搜索,也不会消耗搜索积分。
  • MCP:将检索与展示分离:search、news 和 ask 返回数据,在来源列表有帮助时由 render_results 展示。实验性的 ui URL 参数已移除。标准端点仍为 https://mcp.search1api.com/mcp。
  • MCP:将卡片 UI 打包进 npm 包,修正 Claude 和 ChatGPT 的沙箱元数据,并通过 serverInfo.icons 声明方形 logo。本地安装请通过 npm install -g search1api-mcp@latest 升级,或配置为 npx -y search1api-mcp@latest,然后重启 MCP 连接。参见 MCP 指南。
  • Docs:更新 MCP 落地页和集成指南,补充各传输方式的功能一致性、来源卡片参数、可读的回退内容和升级说明。公共目录中的工具可用性仍取决于各宿主平台的审核。

2026-10-12

  • Integrations:LangChain、n8n、DeepSeek Harness、Hermes、OpenCode 和 OpenClaw 发布 0.2.0。这六个集成均提供仅需 query 的智能搜索(5 积分,45 秒超时)、全部 19 个搜索引擎和 6 个新闻来源、week 以及搜索分页。DSH 默认启用 s1_ask;LangChain 在其工具包中新增 search1api_ask;n8n 新增 Agentic Search。

  • Integrations - 结果字段:搜索/新闻保留每条结果可选的 metadata 和顶层的 published_date;智能搜索保留 intent、结果的 source/relevance 以及可选的 errors。DSH 保留其 link 到 url 的映射。LangChain/Hermes 使用 Python SDK 0.4.0,DSH 使用 TypeScript SDK 0.4.0,OpenCode/OpenClaw 使用 CLI 2.0.0。

  • API - 破坏性响应修正:引擎特有字段移入每条结果的可选 metadata 对象。对于 search_service: "github" 的 POST /search,请读取 metadata.kind、metadata.stars、metadata.language 和 metadata.num_comments。对于 search_service: "hackernews" 的 POST /news,请读取 metadata.story_url、metadata.points 和 metadata.num_comments。旧的顶层字段直接移除,不提供重复别名,也没有弃用过渡期。这是针对近期新增字段、对通常的字段位置兼容性承诺的明确例外。切换到新响应之前,请更新所有读取旧路径的代码。

  • title、link、snippet、可选的 content 和 published_date 仍位于结果顶层;searchParameters 仍位于响应顶层。没有适用的引擎特有字段时省略 metadata。数值零会保留;不可用的字段和为空的文章 URL 会被省略。/ask 和 /trending 不受影响。

  • Clients:TypeScript SDK 0.4.0、Python SDK 0.4.0 和 CLI 2.0.0 的类型通过 metadata 暴露引擎特有字段。MCP 服务器 0.7.1 读取新的 API 对象,同时保持其现有的工具输出结构。AI SDK 工具 0.3.0 依赖 @search1api/client ^0.4.0,并保留嵌套的结果元数据。

2026-10-10

  • API:POST /search 新增 search_service: "grokipedia"。它搜索 xAI 的英文百科 Grokipedia,返回词条标题、链接和开头文本。支持 page;language 和 time_range 会被忽略,结果不含 published_date。
  • SDK:@search1api/client 0.3.0 和 search1api(Python)0.3.0 新增用于 POST /ask 的 ask() 和用于 POST /feedback 的 feedback()。ask() 默认超时为 45 秒;feedback() 从不自动重试。搜索新增 bingcn、yandex 和 grokipedia 引擎以及 page,引擎类型中移除了 sogou,结果类型新增 published_date、github 的 kind、stars、language 和 num_comments 字段,以及 hackernews 新闻的 story_url、points 和 num_comments 字段。参见官方 SDK。
  • CLI:search1api-cli 1.5.0 新增 s1 ask。s1 search 新增 bingcn、yandex 和 grokipedia 引擎以及 -p/--page;s1 search 和 s1 news 支持 -t week,格式化输出会显示 published_date。内置的 Agent Skill 说明了何时使用 search、何时使用 ask。参见 CLI。
  • MCP:search1api-mcp 0.7.0 新增 ask 工具。search 新增 bingcn、yandex 和 grokipedia 引擎以及 page;search 和 news 支持 time_range: "week",结果会透传 published_date,并在 metadata 中透传 GitHub 和 Hacker News 字段。https://mcp.search1api.com/mcp 上的托管服务器运行 0.7.0。Feedback 仍仅通过 API 提供。参见 MCP 服务器。
  • Integrations:@search1api/ai-sdk 0.2.0 新增用于 POST /ask 的 ask 工具。与 MCP 服务器的 ask 工具一样,它默认包含在 search1apiTools() 中;每次调用消耗 5 积分,使用 only: ['search', 'news', 'crawl'] 可保留之前的工具集。search1apiAsk() 可单独创建该工具。search 新增 bingcn、yandex 和 grokipedia 引擎以及 page,search 和 news 支持 time_range: "week"。该包现在依赖 @search1api/client 0.3.0。参见 AI SDK 指南。
  • Docs:优化搜索结果新增 grokipedia 的说明:结果包含的内容、page 支持,以及展示 Grokipedia 内容时的 xAI 署名和许可条款。网站新增 Grokipedia Search API 页面。
  • Docs:Ask、官方 SDK、CLI 和 MCP 服务器页面介绍了新的 SDK 方法、命令和工具。

2026-10-08

  • API:新增 POST /feedback。智能体和应用可以报告 Search1API 的问题、缺失的能力或令人困惑的文档。message 为必填;intent、category(bug、feature_request、docs 或 other)、request_id 和 agent(name、model)为可选,未知字段会被拒绝。报告保存成功后返回 201 和 { "id": "fb_...", "status": "new" }。Feedback 免费,积分耗尽的账户也可使用;支持 API 密钥或 OAuth 令牌,但不支持按请求付费。每个账户在每个 Cloudflare 节点每分钟最多提交 10 次。请求不带幂等键,因此不要自动重试报告。该端点仅通过 API 提供:MCP 服务器和 CLI 不为其新增工具或命令。
  • Integrations:@search1api/ai-sdk 0.1.2 允许模型选择搜索参数,与 MCP 服务器一致:search 和 news 上的 search_service、max_results、include_sites、exclude_sites 和 time_range。在代码中传入的设置会成为默认值。结果页面抓取仍由应用控制,未知的模型参数会被忽略而不会导致调用失败,search 和 news 现在默认返回 10 条结果。参见 AI SDK 指南。
  • Integrations:发布 @search1api/ai-sdk 0.1.1,即用于 Vercel AI SDK 的官方 Search1API 工具包。它通过 search1apiTools() 或单独的工具工厂函数提供 search、news 和 crawl,可用于 generateText 和 streamText。请在服务端配置 Search1API API 密钥,并单独配置模型提供商的凭据。参见 AI SDK 指南和 Next.js 示例。
  • Docs:新增 Vercel 指南,对比 AI SDK 工具与 Vercel Connect。内容涵盖连接器设置,以及如何通过 @vercel/connect 请求用户的 Search1API 凭据。网站现在只有一个 Vercel 集成页面,可从集成目录、导航栏和页脚进入。
  • Docs:新增 Feedback 参考页,介绍请求字段、状态码以及报告中不应包含的内容。

2026-10-07

  • API:不带 search_service 的 POST /search 现在搜索 Google,效果与发送 "search_service": "google" 完全相同。此前它会同时运行多个引擎并合并排名。请求和响应结构不变。POST /news 不受影响。
  • API:POST /ask 现在只接受 query。sources、time_range 和 max_results 请求字段已移除:决策模型始终自行选择引擎和时间范围,每个响应最多包含 10 条结果。仍发送这些字段的请求会被接受,字段会被忽略。如需自行选择引擎和时间范围,请使用 POST /search。此变更在 /ask 上线后一天发布,未按上文所述提前通知。

2026-10-06

  • API:新增 POST /ask。发送自然语言 query;TypeSafe 的 Jev 模型会识别意图并将其路由到最多五个引擎,在查询提及时间时应用 day、week、month 或 year 时间范围,并行搜索这些引擎,再按 Jev 相关性分数重排结果,丢弃低于 0.5 的结果并合并跨引擎的重复项。sources 和 time_range 可覆盖上述任一决策,max_results 限制结果数量(默认 10,最大 20),intent 报告实际使用的关键词、引擎和时间范围。在其他引擎完成时失败的引擎会列在 errors 中。完成的请求固定消耗 5 积分;没有任何引擎完成时 API 返回 502,该请求不计费。/ask 需要 API 密钥,每个账户每分钟最多 30 次请求,且不支持 x402 或 MPP。SDK、CLI 和 MCP 服务器暂未包含该功能。
  • Docs:新增 Ask 参考页,并在选择端点和积分与限制中介绍了 /ask。

2026-10-03

  • Integrations:Search1API 已在 Claude 中以连接器和插件的形式提供。两者连接同一个托管 MCP 服务器,并提供 search、news、crawl、sitemap 和 trending。插件还内置了一个 Search1API Agent Skill,用于引导工具选择并在回答中附上来源链接。两者都通过 OAuth 认证,并使用你的 Search1API 账户积分。
  • Docs:新增 Claude 指南,包含连接器和插件的安装步骤。更新了 MCP 服务器和 Agent Skills 指南,区分已发布的 Claude 集成、手动 MCP 配置以及独立的 Agent Skill + CLI 配置。

2026-09-19

  • Integrations:hermes-search1api 0.1.0 已收录于官方 Hermes 插件目录(NousResearch/hermes-agent#115529),固定在 14c86174。可通过名称安装:hermes plugins install search1api --enable。Hermes Agent v0.21.4(v2026.9.21)是首个包含该条目的版本;v0.21.2 及以后的版本也能从实时目录中解析到它。
  • API:POST /search 新增 search_service: "yandex"。设置 time_range 时,结果包含 published_date(UTC 时间戳);未设置 time_range 时省略该字段。不支持 page——原生 SERP 分页仍仅限 bing、bingcn 和 baidu。

2026-09-18

  • API:search_service: "github" 的 POST /search 现在除仓库外还会返回 issue、pull request 和 discussion。每条结果都带有 kind(repo、issue、pr 或 discussion);仓库还带有 stars 和 language,讨论串带有 num_comments。time_range 按创建日期过滤(此前按最后推送时间过滤,导致“本周”会返回多年前的仓库)。结果先按标题或描述中包含的查询词数量排序,再按 star 数排序;当其他类型也有匹配时,一页结果不再全是同一类型。带有类型专属限定符(is:issue、stars:>100 等)的查询只搜索该类型。Discussion 需要服务配置 GitHub 令牌;没有令牌时仍会返回仓库和 issue/PR。
  • API:search_service: "hackernews" 的 POST /news 现在链接到 Hacker News 讨论串(news.ycombinator.com/item?id=...),而不是提交的文章,并新增 story_url(文章链接;Ask/Show HN 文本帖为空)、points 和 num_comments。多词查询改为匹配任一词而非要求全部匹配,先按匹配的词数排序,再按 points 排序;摘要中不再包含 HTML 实体或标签。
  • API:search_service: "reddit" 的 POST /search 会对每页结果重新排序,让标题或 subreddit 包含查询词的帖子排在前面。Reddit 自身的选取结果保持不变,只改变页内顺序;多词查询会获取更大的一页,以便截取到 max_results 时保留切题的帖子。
  • API:当来源提供发布日期时,POST /search 和 POST /news 的结果会带有 published_date(ISO 8601)。参见按时间或语言缩小范围。
  • API:search_service: "x" 的 POST /search 现在支持 time_range 和 language。此前这两个参数会被接受但被静默忽略。x 仍不支持 page。

2026-09-17

  • Integrations:为 Hermes Agent 发布 hermes-search1api 0.1.0。它将 search1api_search、search1api_news、search1api_crawl、search1api_sitemap 和 search1api_trending 注册为原生 Hermes 工具,并内置 plugin:search1api 技能。安装命令:hermes plugins install superagents-lab/hermes-search1api --enable。
  • API:所有错误响应均为 JSON。每个错误现在都带有 ok: false、一个 error 标签和一条 message。此前 POST /crawl 的死链 404/410 响应返回纯文本。
  • API:GET /deepcrawl/status/{taskId} 对未知任务返回 404,而不是带内部错误信息的 500。
  • API:POST /sitemap 的 400 响应会指出无效字段,而不是返回通用消息。
  • API:POST /crawl 接受 enable_fallback 作为 enableFallback 的别名。两种写法行为相同;OpenAPI 文档中仍保留 enableFallback。

2026-09-13

  • API:POST /search 移除 search_service: "sogou"。发送该值的请求现在会以 422 校验失败;省略该字段即可由 API 选择引擎。

2026-09-12

  • API:POST /search 新增 page,用于在支持的引擎(bing、bingcn、baidu)上进行原生 SERP 分页。其他引擎会忽略该参数。

2026-09-11

  • API:POST /search 新增 search_service: "bingcn"。

2026-09-03

  • MCP:search1api-mcp 0.6.1 恢复对每个 /mcp 请求的认证。0.6.0 曾允许发现类方法匿名通过,导致许多客户端始终不会启动 OAuth:它们把首个 401 加 WWW-Authenticate 视为发起授权的信号。未认证的请求(包括 initialize 和 tools/list)会重新收到该质询。发布说明。

2026-08-26

  • MCP:search1api-mcp 0.6.0 允许 initialize、ping、server/discover、tools/list、prompts/list、resources/list 和 resources/read 在不提供凭据的情况下运行,以便注册表检查程序枚举工具。该改动已在 0.6.1 中回退(见上文)。

2026-08-25

  • API:type: "sitemap" 的 POST /sitemap 现在读取网站的 sitemap 文件,而不是从首页抓取链接。
  • CLI:search1api-cli 1.4.0 新增 s1 learn,可将一个 URL(或配合 --site 将一个文档站点)转换为可安装的 Agent Skill。CLI 不再输出自己的计费估算。

2026-08-21

  • API:POST /crawl 的失效链接按已完成的结果计费。当目标服务器本身返回 404 或 410 时,API 会透传该状态码并附上说明信息,请求消耗 1 积分,与确认零结果的搜索相同。服务失败仍返回 502,且不计费。
  • API:POST /crawl 会透传上游 400 的原因(例如不支持的 URL 协议),而不再报告 502。

2026-08-19

  • SDK:@search1api/client 0.2.1 和 search1api(Python)0.2.1 将内置的 OpenAPI 快照与线上契约重新同步:从 POST /search 和 POST /news 中移除 404,为 POST /screenshot 添加 403,重新生成请求体类型,且每个操作现在都附带描述。包主页改为指向 s1.dev。
  • CLI:search1api-cli 1.3.1 新增 Codex 插件市场目录,并将已发布的 URL 迁移至 s1.dev。
  • MCP:search1api-mcp 0.5.4 在 /.well-known/mcp/server-card.json 提供根据工具列表生成的服务器卡片,使智能体可以在认证之前发现工具。OAuth resource_documentation 及其他元数据现在指向 s1.dev。

2026-08-16

  • Integrations:发布适用于 Factory Droid 的 droid-s1 插件,通过托管 MCP 服务器为 Droid 提供搜索、新闻、抓取、站点地图和热门功能。

2026-08-14

  • Integrations:为 DeepSeek Harness 发布 dsh-s1 0.1.0:以原生工具形式提供 s1_search、s1_news、s1_crawl、s1_sitemap 和 s1_trending,并内置 s1 技能。使用 dsh plugin --profile web add dsh-s1 安装。

2026-08-11

  • API:零结果搜索返回 200。当引擎确认没有匹配项时,POST /search 和 POST /news 会返回 200 和空的 results 数组,并对该请求计费。此前它们返回 404。未能完成的搜索现在返回 502,且不计费。
  • MCP:托管 MCP 服务器和 REST API 的 OAuth 授权服务器迁移至 https://clerk.s1.dev。遵循 /.well-known/oauth-protected-resource 的客户端会自动获取这一变更。

2026-08-10

  • Docs:公共网站从 www.search1api.com 迁移至 s1.dev;文档位于 s1.dev/docs。API 主机 api.search1api.com 和托管 MCP 主机 mcp.search1api.com 保持不变。

2026-08-06

  • Integrations:n8n-nodes-search1api 通过 n8n 审核,已列入官方社区节点目录。

2026-08-04

  • CLI:search1api-cli 1.3.0 将 CLI 打包为 Claude 插件、OpenAI 插件和 Cursor Marketplace 插件,新增 Claude 插件市场目录,并开放 CLI 所基于的可复用客户端。
  • Integrations:发布 opencode-search1api 0.1.1(OpenCode)、openclaw-search1api 0.1.x(OpenClaw,通过 ClawHub)和 grok-search1api 1.0.0(Grok Build),均以工具形式提供搜索、新闻、抓取、站点地图和热门功能。

2026-08-03

  • API:付费端点新增 x-search1api-request-id 响应头。联系支持团队时请提供该值。

2026-08-02

  • MCP:search1api-mcp 0.5.3 从 OAuth 资源元数据中移除 OIDC 会话 scope(openid、profile、email);它们不是资源权限,且会导致 Smithery 授权因 invalid_scope 失败。

2026-07-31

  • Integrations:n8n-nodes-search1api 0.1.3 将 Codex 使用的节点标识符修正为完全限定形式。

2026-07-30

  • MCP:search1api-mcp 0.5.2 在解析和认证之前校验 /mcp 上的 Origin 请求头,并对不受信任的浏览器来源返回 403。自托管部署可通过 MCP_ALLOWED_ORIGINS 允许浏览器客户端。不带 Origin 请求头的服务端客户端不受影响。

2026-07-29

  • MCP:search1api-mcp 0.5.0 和 0.5.1 实现了 MCP 修订版 2026-07-28。远程 HTTP 为无状态:没有 Mcp-Session-Id,也无需粘性路由;每个请求都在 _meta 中携带其协议版本和客户端能力,server/discover 会报告支持的版本和能力。使用 2025 修订版的客户端仍可通过 HTTP 和 stdio 正常工作。每次 HTTP 交互都会校验凭据,并检查 Host 请求头以防范 DNS 重绑定。
  • MCP:移除了冗余的 fetch 工具。公开工具为 search、news、crawl、sitemap 和 trending;原先使用 fetch 的地方请改用 crawl。
  • Integrations:search1api-langchain 0.1.0 发布到 PyPI:提供 Search1APISearch、Search1APINews 和 Search1APICrawl 工具以及 Search1APIToolkit,基于官方 Python SDK 支持同步和异步调用。

2026-07-28

  • MCP:search1api-mcp 0.4.0 为上架公共注册表(Official MCP Registry、LobeHub)做好准备,新增注册表清单和结构化工具输出。
  • Integrations:n8n-nodes-search1api 0.1.1 是 n8n 社区节点的首个版本:将搜索、新闻、抓取、站点地图和热门作为工作流节点以及 n8n AI 工具提供。

2026-07-25

  • API:推出 POST /screenshot。成功时返回 PNG、JPEG 或 WebP 字节,否则返回 JSON 错误;支持整页、视口和元素截图,并提供就绪条件、视口、深色模式、动画和超时控制。每次成功消耗 2 积分,失败的请求不计费;另有单独的限制,每个账户每分钟 10 次请求。
  • SDK:@search1api/client 0.2.0 和 search1api(Python)0.2.0 新增 client.screenshot(),返回二进制图片数据以及内容类型和请求 ID。

2026-07-22

  • API:除 API 密钥外,现在也接受 OAuth 2.1 访问令牌(Authorization Code + PKCE、动态客户端注册、刷新令牌、吊销)作为 Bearer 凭据,二者共用同一账户、积分、速率限制和用量报告。发现元数据位于 /.well-known/oauth-protected-resource。
  • API:在 https://api.search1api.com/openapi.json 发布 OpenAPI 文档。
  • SDK:@search1api/client 0.1.0(ESM 和 CommonJS,生成的类型)和 search1api(Python)0.1.0(同步和异步客户端,类型提示)是首批官方 SDK,覆盖完整的公共契约,提供结构化错误、可配置超时、安全重试、批量操作和深度抓取轮询辅助方法。
  • CLI:search1api-cli 1.2.2 和 1.2.3:s1 login 运行完整的 OAuth 公共客户端流程,并自动刷新过期的访问令牌;移除了已退役的命令;npm 发布实现自动化。
  • MCP:search1api-mcp 0.3.1 为 https://mcp.search1api.com/mcp 上的托管服务器新增 OAuth 支持,与 API 密钥并存。

2026-07-16

  • API:从 POST /search 和 POST /crawl 中移除用户自行提供的代理字段。这些字段现在会被忽略;流量始终通过 Search1API 自有的代理池出站。

2026-07-15

  • Docs:文档基于 Fumadocs 重建,并重新组织为开始使用、基础、指南、集成和 API 参考五部分,并为每个端点明确说明错误和计费行为。

2026-06-09

  • API:POST /v1/chat/completions 和 GET /v1/models 已停用。两者均返回 410 Gone。请改用带 crawl_results 的 POST /search,为你自己的模型提供事实依据。

2026-06-03

  • CLI:search1api-cli 1.2.1 新增 s1 update,用于自动更新独立二进制文件。

2026-04-02

  • CLI:search1api-cli 1.2.0 新增基于浏览器的登录流程。

2026-03-31

  • CLI:search1api-cli 1.1.3 提供适用于 macOS(Apple Silicon 和 Intel)、Linux(x64 和 arm64)及 Windows(x64)的独立二进制文件,无需 Node.js,可通过 curl -fsSL https://cli.search1api.com/install.sh | bash 安装。

2026-03-13

  • CLI:search1api-cli 1.0.0 至 1.1.2 是 s1 的首批版本:在终端中使用搜索、新闻、抓取、站点地图和热门功能,提供更新提醒,并内置 Claude Code 技能。Search1API Agent Skill 从 MCP 仓库迁移至 CLI 仓库。

2026-02-28

  • MCP:search1api-mcp 0.3.0 新增基于 Streamable HTTP 的托管 Remote MCP 服务器(https://mcp.search1api.com/mcp),以及用于容器部署的启动脚本。stdio 包仍可继续使用。

2025-10-16

  • API:POST /search 新增 search_service: "google"。改进了 Bing 分页和英文结果的处理。

2025-08-28

  • API:POST /search 和 POST /news 的 max_results 从 10 提高到 50。

2025-05-05

  • API:推出 POST /extract(beta):使用自然语言提示词和可选的 JSON Schema 从页面中进行结构化提取,每次请求 10 积分。
  • API:推出 POST /deepcrawl(beta):以 sitemap 或 all 模式异步抓取整个网站,启动一个任务消耗 20 积分;GET /deepcrawl/status/{taskId} 免费。
  • API:POST /search 新增 search_service 值 baidu、quark 和 360;POST /news 新增 reuters。

2025-04-14

  • API:对于小红书(RedNote)URL,POST /crawl 会返回笔记正文、图片和视频评论。

2025-04-08

  • API:推出免密钥的免费套餐:大多数端点无需 API 密钥即可调用,受基于 IP 的限制(每分钟 5 次请求,每天 20 次);免费 API 密钥享有每分钟 200 次请求和 100 积分。免密钥访问此后已被按请求付费的支付质询取代;参见认证。

2025-04-05

  • MCP:search1api-mcp 0.2.0 优先从环境变量读取 SEARCH1API_KEY,并回退到项目的 .env,同时补充了 LibreChat 和 Docker 的配置文档。由社区贡献。

2025-04-01

  • API:对于 YouTube URL,POST /crawl 会返回字幕和互动数据(点赞数、观看数);对于 Reddit URL,会返回包含子评论和投票数的完整评论串。

2025-03-28

  • API:POST /search 新增 search_service 值 x 和 reddit。
  • MCP:search1api-mcp 0.1.8 开放 X 和 Reddit 引擎。

2025-03-21

  • API:推出 POST /trending,提供 GitHub Trending 和 Hacker News 榜单。
  • MCP:search1api-mcp 0.1.7 新增 trending 工具。

2025-03-20

  • API:POST /search 新增 search_service: "wikipedia"。
  • MCP:search1api-mcp 0.1.6 开放 Wikipedia 引擎。

2025-03-18

  • MCP:search1api-mcp 0.1.5 为搜索工具新增 include_sites、exclude_sites 和 time_range,并开放三月新增的引擎。

2025-03-17

  • API:POST /search 新增 search_service: "wechat"。

2025-03-16

  • API:POST /search 新增 search_service 值 yahoo、youtube、github、arxiv、bilibili 和 imdb;POST /news 新增 yahoo 和 hackernews。

2025-02-28

  • API:POST /search 和 POST /news 新增 time_range 和 language。移除了 hl 和 gl 参数,改用 language。

2025-02-27

  • API:POST /search 和 POST /news 新增 include_sites 和 exclude_sites。
  • API:修复了一次性积分包随订阅一同过期的问题。

2025-02-21

  • MCP:search1api-mcp 0.1.4 新增由 DeepSeek R1 结合网页搜索驱动的 reasoning 工具(已于 2026 年随推理 API 一同停用),并提供 Cursor 和 Windsurf 配置指南。

2025-02-17

  • API:在 POST /v1/chat/completions 推出推理搜索,由 DeepSeek R1 结合网页搜索提供事实依据。已于 2026-06-09 停用。

2025-02-08

  • API:默认搜索语言改为英语,提升了未指定语言的查询的结果质量。

2025-01-12

  • API:计费改为按结果计费:每次成功的搜索和每次成功的抓取都会扣除积分;失败的抓取不再计费。

2024-12-05

  • MCP:search1api-mcp 0.1.3 新增 news 工具。

2024-11-29

  • MCP:search1api-mcp 0.1.2 新增 sitemap 工具。

2024-11-26

  • MCP:search1api-mcp 0.1.0 和 0.1.1 是首个 Search1API MCP 服务器,通过 stdio 提供 search 和 crawl 工具。

2024-04-29

  • API:Search1API 上线,提供 POST /search、POST /crawl 以及首份公开文档。

本页内容