更新日志
Search1API 的兼容性承诺,以及 API、SDK、CLI 和 MCP 服务器按日期记录的变更。
本页记录所有开发者接口的变更:HTTP API 契约(端点、请求与响应字段、状态码、请求头、计费规则)、官方 SDK、CLI 和 MCP 服务器。每条记录都标注了其影响的范围。产品和仪表盘更新见产品更新日志。
当前版本
| 类型 | 包 | 版本 | 发布日期 |
|---|---|---|---|
| TypeScript SDK | @search1api/client | 0.4.0 | 2026-10-12 |
| Vercel AI SDK 工具 | @search1api/ai-sdk | 0.3.0 | 2026-10-12 |
| Python SDK | search1api | 0.4.0 | 2026-10-12 |
| CLI | search1api-cli | 2.0.0 | 2026-10-12 |
| MCP 服务器 | search1api-mcp | 0.8.0 | 2026-10-14 |
| LangChain | search1api-langchain | 0.2.0 | 2026-10-12 |
| n8n | n8n-nodes-search1api | 0.2.0 | 2026-10-12 |
| DeepSeek Harness | dsh-s1 | 0.2.0 | 2026-10-12 |
| Hermes | hermes-search1api | 0.2.0 | 2026-10-12 |
| OpenCode | opencode-search1api | 0.2.0 | 2026-10-12 |
| OpenClaw | openclaw-search1api | 0.2.0 | 2026-10-12 |
| Grok Build | grok-search1api | 1.0.0 | 2026-08-04 |
| Factory Droid | droid-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-mcp0.8.0 在远程 HTTP 和本地 stdio 中新增render_results。模型可以在 MCP Apps 客户端中把选定的已有来源显示为交互式卡片;所有客户端也都会收到结构化 JSON 和完整的文本列表。渲染和展开来源不会重复搜索,也不会消耗搜索积分。 - MCP:将检索与展示分离:
search、news和ask返回数据,在来源列表有帮助时由render_results展示。实验性的uiURL 参数已移除。标准端点仍为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/client0.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-cli1.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-mcp0.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-sdk0.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/client0.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-sdk0.1.2 允许模型选择搜索参数,与 MCP 服务器一致:search和news上的search_service、max_results、include_sites、exclude_sites和time_range。在代码中传入的设置会成为默认值。结果页面抓取仍由应用控制,未知的模型参数会被忽略而不会导致调用失败,search 和 news 现在默认返回 10 条结果。参见 AI SDK 指南。 - Integrations:发布
@search1api/ai-sdk0.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-search1api0.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-search1api0.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-mcp0.6.1 恢复对每个/mcp请求的认证。0.6.0 曾允许发现类方法匿名通过,导致许多客户端始终不会启动 OAuth:它们把首个401加WWW-Authenticate视为发起授权的信号。未认证的请求(包括initialize和tools/list)会重新收到该质询。发布说明。
2026-08-26
- MCP:
search1api-mcp0.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-cli1.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/client0.2.1 和search1api(Python)0.2.1 将内置的 OpenAPI 快照与线上契约重新同步:从POST /search和POST /news中移除404,为POST /screenshot添加403,重新生成请求体类型,且每个操作现在都附带描述。包主页改为指向s1.dev。 - CLI:
search1api-cli1.3.1 新增 Codex 插件市场目录,并将已发布的 URL 迁移至s1.dev。 - MCP:
search1api-mcp0.5.4 在/.well-known/mcp/server-card.json提供根据工具列表生成的服务器卡片,使智能体可以在认证之前发现工具。OAuthresource_documentation及其他元数据现在指向s1.dev。
2026-08-16
- Integrations:发布适用于 Factory Droid 的
droid-s1插件,通过托管 MCP 服务器为 Droid 提供搜索、新闻、抓取、站点地图和热门功能。
2026-08-14
- Integrations:为 DeepSeek Harness 发布
dsh-s10.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-cli1.3.0 将 CLI 打包为 Claude 插件、OpenAI 插件和 Cursor Marketplace 插件,新增 Claude 插件市场目录,并开放 CLI 所基于的可复用客户端。 - Integrations:发布
opencode-search1api0.1.1(OpenCode)、openclaw-search1api0.1.x(OpenClaw,通过 ClawHub)和grok-search1api1.0.0(Grok Build),均以工具形式提供搜索、新闻、抓取、站点地图和热门功能。
2026-08-03
- API:付费端点新增
x-search1api-request-id响应头。联系支持团队时请提供该值。
2026-08-02
- MCP:
search1api-mcp0.5.3 从 OAuth 资源元数据中移除 OIDC 会话 scope(openid、profile、email);它们不是资源权限,且会导致 Smithery 授权因invalid_scope失败。
2026-07-31
- Integrations:
n8n-nodes-search1api0.1.3 将 Codex 使用的节点标识符修正为完全限定形式。
2026-07-30
- MCP:
search1api-mcp0.5.2 在解析和认证之前校验/mcp上的Origin请求头,并对不受信任的浏览器来源返回403。自托管部署可通过MCP_ALLOWED_ORIGINS允许浏览器客户端。不带Origin请求头的服务端客户端不受影响。
2026-07-29
- MCP:
search1api-mcp0.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-langchain0.1.0 发布到 PyPI:提供Search1APISearch、Search1APINews和Search1APICrawl工具以及Search1APIToolkit,基于官方 Python SDK 支持同步和异步调用。
2026-07-28
- MCP:
search1api-mcp0.4.0 为上架公共注册表(Official MCP Registry、LobeHub)做好准备,新增注册表清单和结构化工具输出。 - Integrations:
n8n-nodes-search1api0.1.1 是 n8n 社区节点的首个版本:将搜索、新闻、抓取、站点地图和热门作为工作流节点以及 n8n AI 工具提供。
2026-07-25
- API:推出
POST /screenshot。成功时返回 PNG、JPEG 或 WebP 字节,否则返回 JSON 错误;支持整页、视口和元素截图,并提供就绪条件、视口、深色模式、动画和超时控制。每次成功消耗 2 积分,失败的请求不计费;另有单独的限制,每个账户每分钟 10 次请求。 - SDK:
@search1api/client0.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/client0.1.0(ESM 和 CommonJS,生成的类型)和search1api(Python)0.1.0(同步和异步客户端,类型提示)是首批官方 SDK,覆盖完整的公共契约,提供结构化错误、可配置超时、安全重试、批量操作和深度抓取轮询辅助方法。 - CLI:
search1api-cli1.2.2 和 1.2.3:s1 login运行完整的 OAuth 公共客户端流程,并自动刷新过期的访问令牌;移除了已退役的命令;npm 发布实现自动化。 - MCP:
search1api-mcp0.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-cli1.2.1 新增s1 update,用于自动更新独立二进制文件。
2026-04-02
- CLI:
search1api-cli1.2.0 新增基于浏览器的登录流程。
2026-03-31
- CLI:
search1api-cli1.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-cli1.0.0 至 1.1.2 是s1的首批版本:在终端中使用搜索、新闻、抓取、站点地图和热门功能,提供更新提醒,并内置 Claude Code 技能。Search1API Agent Skill 从 MCP 仓库迁移至 CLI 仓库。
2026-02-28
- MCP:
search1api-mcp0.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-mcp0.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-mcp0.1.8 开放 X 和 Reddit 引擎。
2025-03-21
- API:推出
POST /trending,提供 GitHub Trending 和 Hacker News 榜单。 - MCP:
search1api-mcp0.1.7 新增trending工具。
2025-03-20
- API:
POST /search新增search_service: "wikipedia"。 - MCP:
search1api-mcp0.1.6 开放 Wikipedia 引擎。
2025-03-18
- MCP:
search1api-mcp0.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-mcp0.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-mcp0.1.3 新增news工具。
2024-11-29
- MCP:
search1api-mcp0.1.2 新增sitemap工具。
2024-11-26
- MCP:
search1api-mcp0.1.0 和 0.1.1 是首个 Search1API MCP 服务器,通过 stdio 提供search和crawl工具。
2024-04-29
- API:Search1API 上线,提供
POST /search、POST /crawl以及首份公开文档。