← Updates

Public API 与 MCP 2.4:过滤器、注释、分享与 SEO enrich

已保存过滤器、报告标签与备注、访客分享链接和 SEO 指标补全 — 通过 REST API 与 MCP。31 个工具(原 21 个),同一把 API key。

Public API 和 MCP 服务器 现已支持完整的报告工作流 — 此前仅在 Web 应用中可用。从个人资料 → 设置获取一把 Bearer 密钥;每分钟 60 次请求的限制由 REST 与 MCP 共享。

MCP 现为 31 个工具(此前 21 个)。新增 Report workflow 分组 — REST 端点同样分为:Reports、Account、Report workflow、Live checkers。

已保存过滤器

按名称保存搜索过滤器组合,从脚本或聊天中调用。

  • REST: GET / PUT / DELETE /v1/user/saved-filters
  • MCP: list_saved_filters、save_saved_filter、delete_saved_filter

注释与标签

每条报告最多 200 字备注、最多 10 个标签 — 适用于 shortlist、CRM 与团队协作。

  • REST: GET /v1/reports/annotations/tags,GET / PUT / DELETE /v1/reports/annotations
  • MCP: list_annotation_tags、get_report_annotation、set_report_annotation、delete_report_annotation

访客分享链接

无需账户访问即可将报告发给同事或客户。

  • REST: POST /v1/reports/share → 响应中的 share_url
  • MCP: create_share_link

请求体使用搜索或完整报告中的 report_type 和 report_id。

通过 API 进行 SEO enrich

补全缺失的 SEO 指标 现已支持程序化调用 — 在系统队列之外,与报告页一致。

  • REST: POST /v1/reports/{report_type}/{report_id}/enrich-seo(响应 202 + job_id),然后轮询 GET /v1/reports/enrich-jobs/{job_id} 直至状态 done
  • MCP: enrich_report_seo、get_enrich_report_seo_job

若已连接 MCP

无需更改 URL 或密钥。客户端按会话缓存工具列表 — 请打开新对话或重启 Cursor / Claude / ChatGPT。新的 REST 路由立即可用。

详情、curl 示例与字段模式见更新后的 API 与 MCP 落地页;完整模式见 Swagger UI。