apiwatch

apiwatch

及时了解你依赖的 API、模型或 MCP 服务何时发生变更，以及代码中的哪些行会因此受影响。

供应商会按你无法掌控的时间表淘汰模型、重命名 MCP 工具并更改 API 行为。这些变更大多会发布在团队里没人看的更新日志中。apiwatch 会替你阅读这些信息，而它的 GitHub Action 会在停用日期前，精准指出变更影响到的代码行。

• **信息流：**涵盖 OpenAI、Anthropic、Google、Stripe、Twilio、Notion、Atlassian、GitHub、xAI 等供应商，经审核的破坏性变更、静默变更和弃用记录。每条记录都引用供应商自己的页面，并且每天都会重新核查。可在 apiwatch.reignventures.co 浏览（也提供 Atom 和 JSON Feed）。
• **扫描：**查找代码库中每项变更影响到的调用位置。支持识别 token 边界（gpt-4 不会匹配 gpt-4o）、追踪常量、读取笔记本，并区分实际使用与模型列表中的条目。
• **变更简报：**针对每处命中，说明变更内容、位置、建议的修复方案，以及可交给编码 Agent 的验收标准。
• **探测：**为实时 JSON 端点或 MCP 服务的 tools/list 建立基线，并在内容发生偏移时通知你，无需规范文件。

检测到的变更

信息流包含 126 条经审核的变更记录，每条都已对照供应商自己的页面核实。

• **按供应商：**Google 33 条、OpenAI 26 条、Stripe 24 条、Anthropic 16 条、Notion MCP 8 条、GitHub MCP Server 4 条、xAI 4 条、Atlassian Rovo MCP 3 条、Notion 3 条、Twilio 3 条、Greenhouse 1 条、MCP specification 1 条
• **按严重程度：**破坏性变更 92 条、静默变更 25 条、弃用 9 条

接下来发生的变更（未来 180 天内的所有变更）：

• 2026 年 11 月 2 日，xAI，静默变更：自 2026 年 11 月 2 日起，grok-imagine-image-quality 请求将由 grok-imagine-image-2.0 以低质量提供服务；该别名仍可使用，但模型和价格会发生变化
• 2026 年 11 月 30 日，Anthropic，破坏性变更：Anthropic 将于 2026 年 11 月 30 日在 Claude API 上停用 Claude Sonnet 4.5 (claude-sonnet-4-5-20250929)；此日期之后，对该模型的请求将失败。
• 2026 年 11 月 30 日，OpenAI，破坏性变更：OpenAI 可复用提示词对象和 v1/prompts API 将于 2026 年 11 月 30 日关闭
• 2026 年 12 月 1 日，OpenAI，破坏性变更：OpenAI 将于 2026 年 12 月 1 日从 API 中移除 gpt-image-1-mini、gpt-image-1.5 和 chatgpt-image-latest；替代模型为 gpt-image-2.5-sunburst 或 gpt-image-2.5-flare。
• 2026 年 12 月 11 日，OpenAI，破坏性变更：OpenAI 将于 2026 年 12 月 11 日移除较早版本的 GPT-5 和 o3 快照（gpt-5-2025-08-07、gpt-5-mini/nano-2025-08-07、gpt-5-pro-2025-10-06、o3-2025-04-16、o3-pro-2025-06-10）。

GitHub Action

name: apiwatch
on: [push, pull_request]
jobs:
  scan:
    runs-on: ubuntu-latest
    permissions: { contents: read, pull-requests: write }
    steps:
      - uses: actions/checkout@v4
      - uses: ReignVentures/apiwatch@v1
        with:
          fail-on-breaking: "true"   # fail CI when a breaking or silent change touches your code
          comment: "true"            # keep one up to date report comment on pull requests
          only-changed: "true"       # on PRs, gate only on the files the PR changes

每次运行都会在作业摘要中写入简短报告：哪些变更影响你的代码、严重程度如何、日期已过还是将至，以及每处位置的链接。添加 SARIF 上传，即可将命中结果显示为代码扫描注释：

      - uses: github/codeql-action/upload-sarif@v3
        if: always()
        with: { sarif_file: apiwatch.sarif }

提示：添加 schedule: 触发器（例如每日运行），这样即使没人推送代码，你也能及时了解新变更。

CLI

pip install git+https://github.com/ReignVentures/apiwatch
apiwatch scan . --fail-on-breaking --markdown report.md
apiwatch probe docs "mcp:stdio:npx -y @modelcontextprotocol/server-everything"
apiwatch probe docs mcp:https://example.com/mcp --header 'Authorization: Bearer $TOKEN' --fail-on-drift

扫描会在本地运行，不会发起网络请求。你的代码不会离开本机或 CI 运行器。

若要在扫描中排除生成或复制的文件，请在代码库根目录添加 .apiwatchignore 文件：每行一个 glob（agents/*.json），目录末尾加 /（generated/），使用 # 添加注释。默认跳过翻译目录（locales/、i18n/）。

MCP 服务

AI Agent 可以在工作时直接查询更新源：这个模型 ID 或 API 是否有已发布的变更？何时发布？有什么替代方案？ 一个公开 URL，无需安装，无需账号：https://apiwatch.reignventures.co/mcp（Streamable HTTP，支持 2026-07-28 及更早的 initialize 协议时期）。

claude mcp add --transport http apiwatch https://apiwatch.reignventures.co/mcp

工具：check_model、check_identifiers、list_upcoming、search_changes、get_record。它只根据网站发布的已审核记录作答，不会存储发送给它的任何内容；对于它不认识的 ID，它会回答“无记录”（绝不会说“安全”）。其他客户端的设置说明：https://apiwatch.reignventures.co/mcp-server

另外两个工具 list_watched_mcp_servers 和 mcp_server_changes 会根据 apiwatch 对部分公开 MCP 服务的变更记录（https://apiwatch.reignventures.co/mcp-servers/）作答：工具被移除或重命名、新增必需参数、描述被重写、提示信息发生变更。它们绝不会返回服务自身的工具描述。

记录如何验证

只有在一位未参与撰写记录的审核人员根据供应商的主要来源核对每个字段，且自动检查确认引用的证据仍在该页面上之后，记录才会发布。完整规则见 docs/REVIEW.md。如果供应商编辑或移除了页面，该记录会从网站下架，直至重新审核。

发现我们遗漏的变更，或记录有误？请附上供应商页面链接并提交 issue。

apiwatch Pro

Pro 每晚监控你 GitHub 组织中的每个仓库，无需在工作流中添加任何内容；当代码中出现新的变更时，它会创建 issue。每月 $19。详见 Pro 的工作方式。

许可证

MIT。由 Reign Ventures LLC 构建。