# 更新日志 > Search1API 的兼容性承诺，以及 API、SDK、CLI 和 MCP 服务器按日期记录的变更。 Canonical URL: https://s1.dev/zh/docs/changelog 本页记录所有开发者接口的变更：HTTP API 契约（端点、请求与响应字段、状态码、请求头、计费规则）、官方 SDK、CLI 和 MCP 服务器。每条记录都标注了其影响的范围。产品和仪表盘更新见[产品更新日志](https://s1.dev/changelog)。 ## 当前版本 | 类型 | 包 | 版本 | 发布日期 | | --- | --- | --- | --- | | TypeScript SDK | [`@search1api/client`](https://github.com/superagents-lab/search1api-js/releases) | 0.4.0 | 2026-10-12 | | Vercel AI SDK 工具 | [`@search1api/ai-sdk`](https://github.com/superagents-lab/search1api-ai-sdk/releases) | 0.3.0 | 2026-10-12 | | Python SDK | [`search1api`](https://github.com/superagents-lab/search1api-python/releases) | 0.4.0 | 2026-10-12 | | CLI | [`search1api-cli`](https://github.com/superagents-lab/search1api-cli/releases) | 2.0.0 | 2026-10-12 | | MCP 服务器 | [`search1api-mcp`](https://github.com/superagents-lab/search1api-mcp/releases) | 0.8.0 | 2026-10-14 | | LangChain | [`search1api-langchain`](https://github.com/superagents-lab/search1api-langchain/releases) | 0.2.0 | 2026-10-12 | | n8n | [`n8n-nodes-search1api`](https://github.com/superagents-lab/n8n-nodes-search1api/releases) | 0.2.0 | 2026-10-12 | | DeepSeek Harness | [`dsh-s1`](https://github.com/superagents-lab/dsh-s1/releases) | 0.2.0 | 2026-10-12 | | Hermes | [`hermes-search1api`](https://github.com/superagents-lab/hermes-search1api) | 0.2.0 | 2026-10-12 | | OpenCode | [`opencode-search1api`](https://github.com/superagents-lab/opencode-search1api) | 0.2.0 | 2026-10-12 | | OpenClaw | [`openclaw-search1api`](https://github.com/superagents-lab/openclaw-search1api) | 0.2.0 | 2026-10-12 | | Grok Build | [`grok-search1api`](https://github.com/superagents-lab/grok-search1api) | 1.0.0 | 2026-08-04 | | Factory Droid | [`droid-s1`](https://github.com/superagents-lab/droid-s1) | 无版本号 | 2026-08-16 | HTTP API 没有版本号。变更通常是新增性的；明确的兼容性例外会记录在下方。 ## 兼容性承诺 Search1API 不在 API URL 中区分版本。默认的兼容性规则如下： - **新增性变更不另行通知。** 新端点、新的可选请求字段、新的响应字段、新的枚举值和新的响应头可能随时出现。请忽略无法识别的响应字段。 - **未知的请求字段会被忽略。** 发送 API 已不再读取的字段不会导致请求失败。 - **现有字段保持名称、类型和位置不变。** 下方 2026-10-12 的元数据修正是针对近期新增的引擎特有字段的一次性例外；默认规则仍是不对现有字段重命名、更改类型或移动位置。 - **移除会先在此公告。** 当某个端点或字段必须移除时，本页和[产品更新日志](https://s1.dev/changelog)会在变更上线前公告。已移除的端点会继续以 `410 Gone` 响应，并在消息中注明替代方案。 - **状态码属于契约的一部分。** 状态码含义的变化（例如零结果搜索从 `404` 改为 `200`）会连同上线日期记录在下方。 机器可读的契约是 [OpenAPI 文档](https://api.search1api.com/openapi.json)。官方 [SDK](https://s1.dev/zh/docs/integrations/sdks)、[CLI](https://s1.dev/zh/docs/integrations/cli) 和 [MCP 服务器](https://s1.dev/zh/docs/integrations/mcp)均基于该契约构建，会在下一次发布时纳入新增性变更；它们各自的发布遵循语义化版本，并与 API 变更一起列在本页。 > **info:** 新的请求字段使用 `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](https://s1.dev/compatible-apis/searxng)、[Google CSE](https://s1.dev/compatible-apis/google-cse) 和 [Bing v7](https://s1.dev/compatible-apis/bing) 专属迁移指南，提供英文、中文和日文版本。兼容 API 页面现在把迁移指南与引擎产品页、技术参考分开链接。 - **API**：新增 [Google Custom Search JSON API 兼容端点](https://s1.dev/zh/docs/compatibility/google)，在 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](https://s1.dev/zh/docs/compatibility/overview)。 - **Docs**：[兼容 API](https://s1.dev/zh/docs/compatibility/overview) 新增概览页，并为每个 API 提供一页说明，涵盖客户端配置、参数映射、响应差异、积分和错误格式。官网也有[兼容 API 页面](https://s1.dev/compatible-apis)。 ### 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 指南](https://s1.dev/zh/docs/integrations/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`](https://s1.dev/zh/docs/basic/ask) 的 `ask()` 和用于 [`POST /feedback`](https://s1.dev/zh/docs/utility/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](https://s1.dev/zh/docs/integrations/sdks)。 - **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](https://s1.dev/zh/docs/integrations/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 服务器](https://s1.dev/zh/docs/integrations/mcp)。 - **Integrations**：`@search1api/ai-sdk` 0.2.0 新增用于 [`POST /ask`](https://s1.dev/zh/docs/basic/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 指南](https://s1.dev/zh/docs/integrations/vercel-ai-sdk)。 - **Docs**：[优化搜索结果](https://s1.dev/zh/docs/guides/improving-search-results)新增 `grokipedia` 的说明：结果包含的内容、`page` 支持，以及展示 Grokipedia 内容时的 xAI 署名和许可条款。网站新增 [Grokipedia Search API 页面](https://s1.dev/grokipedia-search-api)。 - **Docs**：[Ask](https://s1.dev/zh/docs/basic/ask)、[官方 SDK](https://s1.dev/zh/docs/integrations/sdks)、[CLI](https://s1.dev/zh/docs/integrations/cli) 和 [MCP 服务器](https://s1.dev/zh/docs/integrations/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 指南](https://s1.dev/zh/docs/integrations/vercel-ai-sdk)。 - **Integrations**：发布 `@search1api/ai-sdk` 0.1.1，即用于 Vercel AI SDK 的官方 Search1API 工具包。它通过 `search1apiTools()` 或单独的工具工厂函数提供 `search`、`news` 和 `crawl`，可用于 `generateText` 和 `streamText`。请在服务端配置 Search1API API 密钥，并单独配置模型提供商的凭据。参见 [AI SDK 指南](https://s1.dev/zh/docs/integrations/vercel-ai-sdk)和 [Next.js 示例](https://github.com/superagents-lab/search1api-ai-sdk/tree/main/examples/nextjs)。 - **Docs**：新增 [Vercel 指南](https://s1.dev/zh/docs/integrations/vercel)，对比 AI SDK 工具与 [Vercel Connect](https://vercel.com/connect/search1api)。内容涵盖连接器设置，以及如何通过 `@vercel/connect` 请求用户的 Search1API 凭据。网站现在只有一个 [Vercel 集成页面](https://s1.dev/integrations/vercel)，可从集成目录、导航栏和页脚进入。 - **Docs**：新增 [Feedback](https://s1.dev/zh/docs/utility/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](https://s1.dev/zh/docs/basic/ask) 参考页，并在[选择端点](https://s1.dev/zh/docs/guides/choosing-an-endpoint)和[积分与限制](https://s1.dev/zh/docs/essentials/credits-and-limits)中介绍了 `/ask`。 ### 2026-10-03 - **Integrations**：Search1API 已在 Claude 中以[连接器](https://claude.ai/directory/search1api)和[插件](https://claude.ai/customize/plugins/id/c73feffb-aae4-49f4-8515-24322b313989%40anthropic-plugin-directory)的形式提供。两者连接同一个托管 MCP 服务器，并提供 `search`、`news`、`crawl`、`sitemap` 和 `trending`。插件还内置了一个 Search1API Agent Skill，用于引导工具选择并在回答中附上来源链接。两者都通过 OAuth 认证，并使用你的 Search1API 账户积分。 - **Docs**：新增 [Claude 指南](https://s1.dev/zh/docs/integrations/claude)，包含连接器和插件的安装步骤。更新了 [MCP 服务器](https://s1.dev/zh/docs/integrations/mcp)和 [Agent Skills](https://s1.dev/zh/docs/integrations/skills) 指南，区分已发布的 Claude 集成、手动 MCP 配置以及独立的 Agent Skill + CLI 配置。 ### 2026-09-19 - **Integrations**：`hermes-search1api` 0.1.0 已收录于官方 [Hermes 插件目录](https://hermes-agent.nousresearch.com/docs/plugins/search1api)（[NousResearch/hermes-agent#115529](https://github.com/NousResearch/hermes-agent/pull/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）。参见[按时间或语言缩小范围](https://s1.dev/zh/docs/guides/improving-search-results#narrow-by-time-or-language)。 - **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`）会重新收到该质询。[发布说明](https://github.com/superagents-lab/search1api-mcp/releases/tag/v0.6.1)。 ### 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 积分。免密钥访问此后已被按请求付费的支付质询取代；参见[认证](https://s1.dev/zh/docs/essentials/authentication)。 ### 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` 以及首份公开文档。