FeedMCP

技术指南

生产级 AI Agent 防花超指南:Key 上限、X-Max-Price 与 Idempotency-Key

让 Claude、Cursor 或自研 Agent 自主调用外部付费接口时,开发者最担心两件事:Agent 陷入翻页死循环把余额刷空,以及网络超时重试导致重复扣费。FeedMCP 在网关层内置了三道硬防线。

涉及的接口与价格

接口 路径 单价
抖音热榜 GET /v1/douyin/trends/list $0.002
TikTok 视频评论 GET /v1/tiktok/videos/comments/list $0.002
小红书笔记评论 GET /v1/xiaohongshu/notes/comments/list $0.02

实现步骤

1. 第一道防线:给每个 Agent 单独建 Key 并设总花费上限

在控制台为不同 Agent/脚本建独立 Key 并设美元上限,触发后立即返回 key_spend_cap_reached(不扣费),不影响其他业务 Key。

2. 第二道防线:每次请求带 X-Max-Price(MCP 传 max_price)

在调用前声明单次最高愿意支付的价格,若 Agent 误选了高价接口(如 $0.10 微信指数),网关在调用上游前直接拒绝并免费返回 price_above_max。

3. 第三道防线:重试务必带同一个 Idempotency-Key

网络超时不确定是否成功时,用相同的 Idempotency-Key 重发,24 小时内只扣一次费并重放首次结果(响应头 Idempotent-Replayed: true)。

完整代码示例

import os, time, uuid, requests

def safe_call(path: str, params: dict, max_price: str = "0.02", retries: int = 2):
    idem_key = str(uuid.uuid4())
    for attempt in range(retries + 1):
        r = requests.get(
            f"https://api.feedmcp.com{path}",
            params=params,
            headers={
                "Authorization": f"Bearer {os.environ['FEEDMCP_API_KEY']}",
                "X-Max-Price": max_price,
                "Idempotency-Key": idem_key,
            },
            timeout=30,
        )
        body = r.json()
        if body.get("code") == "ok":
            return body
        # 严格遵循服务端 retry 建议:no / after_fix 立即停,不要盲目死循环
        if body.get("retry") not in ("yes", "once", "same_key"):
            raise RuntimeError(f"Stop: {body.get('code')} - {body.get('message')}")
        time.sleep(body.get("retry_after_seconds") or (attempt + 1) * 2)
    raise RuntimeError("Retries exhausted")

费用估算

全部错误响应都明确返回 charged: false 与 retry 枚举值,让 Agent 逻辑完全确定可控。详见 计费文档 和 错误码。

常见问题

跑完这份教程大概要花多少钱?

全部错误响应都明确返回 charged: false 与 retry 枚举值,让 Agent 逻辑完全确定可控。详见 计费文档 和 错误码。

没有代码基础,能在 AI 里直接完成同样的事吗?

可以。把 FeedMCP 的 MCP 服务装进 Claude、Cursor 或 Cherry Studio 后,用自然语言即可完成同样的查询与汇总。

更多指南