SEO 调研用 Claude MCP 工具服务器，带单次调用预算限制
一个私有 MCP 服务器，让 Claude 能调用 25+ 个付费 SEO / 数据分析工具 —— 每次付费调用先估价，超预算直接拒绝并返回预估，不会做到一半才停；查询有重叠时只为新增部分付费。
TypeScript
Cloudflare个人项目AI概述
付费 SEO 数据 API 是按次计费的，AI agent 一旦放开调用，账单会涨得很快。我做了一个私有 MCP 服务器，让 Claude 能用 25+ 个工具做关键词和 SERP 调研、竞品分析、反链、AI 搜索可见度、Search Console 和站点数据分析——成本控制是写在协议层里的，不是事后补上去的。每次付费调用在执行前先估价；超出预算就直接拒绝并返回预估，绝不会执行到一半才被打断。缓存按单条数据存，查询和之前有重叠时只为新增的部分付费。上游出错时返回明确的错误类型，不是笼统的 500。我自己用它做站点的 SEO 调研和排名跟踪。个人项目，非付费客户项目；私有仓库。
问题：开放调用，账单无底洞
付费 SEO 服务商提供的关键词、SERP、竞品和反链数据都是按次计费的。给 AI agent 开放调用这类 API，它会很乐意为了把一个问题答透而反复调用——这正是账单失控的典型路径。我希望 Claude 能自由地用这些工具为我自己做 SEO 调研，但单次会话能花多少钱要有硬上限，而且这个上限要在调用真正发生的地方强制生效，不能指望模型自己把握。
25+ 个工具，一道预算闸门
这个服务器向 Claude 暴露 25+ 个工具：关键词和 SERP 调研、竞品分析、反链、AI 搜索可见度跟踪、Search Console 数据和通用站点分析。每一个会打到付费上游 API 的工具都先过同一道闸门：估算这次具体调用要花多少钱，和会话预算的剩余额度比较，通过了才真正执行。如果预估超出剩余预算，调用会被直接拒绝，返回的是预估金额——由 Claude（或者我）来决定这笔钱花得值不值，而不是等事后才发现花了多少。
缓存只为新数据付费，不为重复提问付费
结果按单条数据缓存，而不是按整次查询缓存。当一个新查询和之前跑过的某次有部分重叠，服务器只为缺的那部分数据向上游付费——重叠的部分直接从缓存免费返回。结合预算闸门，这意味着 Claude 为了真正调研一个主题所需要的那种反复试探式提问，不会每次细化问题就把成本再乘一遍。
类型化错误，不是笼统的 500
当上游服务出错时——限流、配额用尽、响应格式异常、超时——服务器会返回一个类型化的错误，而不是让它坍缩成一个笼统的失败。这对 AI 客户端和对人一样重要：Claude 能分辨出「稍后重试」和「这个查询本身就不合法」的区别，并据此采取不同的动作，而不是只能报告「出错了」。
技术栈
TypeScript，部署在 Cloudflare Workers 上。
