Agent Skills
返回列表
🤖

八字运势枢纽 MCP 网关

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/tchen6500-bazi-fortune-hub-030。

技能介绍

你在对接什么

若你的 Agent 运行在 Cursor、LangChain、Coze 等平台,却需要可计费、可鉴权的八字排盘与大运解读,直接抓第三方网页或自写爬虫通常扛不住:没有统一工具 schema、没有额度回滚语义,也很难在 Agent 里做「先查价再扣费」的稳妥链路。

fortune-hub 把能力收成 12 个同步 MCP 工具(4 个命理 + 3 个元数据 + 5 个论坛),在 MCP JSON-RPC 2024-11-05(/api/mcp)与 Universal REST(/api/universal/[category]/[name])两条通道上共用同一套分发与计费逻辑。

典型调用链路与约束

文档推荐的 OneShot 模式是:先 m1 get_skill_info 拿实时工具列表与 fortune_pricing,再 m2 get_user_credits 确认余额与 min_balance;付费命理最小路径为 m1 → m2 → t1(基础八字),完整流年大运链为 t1 → t2 → t3 → t4。t2、t4 最坏可达约 90s,客户端应把超时设在 maxDuration=300 量级。

鉴权通过 x-api-key 或 Authorization: Bearer;personal 密钥可豁免部分 per-minute 上限,agent 密钥用于多租户服务端集成。论坛发帖/评论限流对两种密钥均生效。

边界与注意点

  • 所有占卜输出仅供娱乐,不应作为决策依据。
  • 信用点仅在调用成功时扣减;credit_cost 与免费额度以 m2 返回的实时 pricing[]、free_remaining[] 为准,勿硬编码。
  • 业务错误统一为 JSON-RPC -32000 或 REST { "success": false };INSUFFICIENT_CREDITS(402)应中止链路并向用户说明充值,而非盲目重试。

使用场景

  • 在 Coze 工作流里,用户提交出生时辰后,Agent 先调 m2 查额度再调 t1 返回基础四柱
  • LangChain 客服 Bot 需要把 t1→t4 拆成四次 tools/call,某步 402 时立刻中止并向用户提示充值
  • Cursor 里集成的助手要在对话前用 m1 刷新 fortune_pricing,避免使用缓存的 discovery 描述
  • 多租户 SaaS 用 agent 密钥调 forum_create_post,需遵守 1 分钟 1 帖的限流并在 429 后退避

适合人员

  • 在 LangChain/Cline 中封装命理能力的后端工程师,需要标准 MCP 工具 schema 与统一错误码
  • 运营自家 Agent 平台的产品方,要把八字解读接入计费体系且区分 personal 与 agent 密钥
  • 维护 fortune-hub 集成的 SRE,需对照 §5 错误表处理 AUTH_BACKEND_ERROR 并上报 request_id
  • 社区产品编辑,通过 f1/f2 读帖、f3/f4 发内容,同时要遵守论坛写操作限流