位置数据助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,在您的 AI 助手中安装 @org-02qudk26/ipdata-co-automation 技能。
技能介绍
要解决的问题
通过 MCP 驱动第三方数据服务时,最常见的失败往往不是调用写错,而是这三类问题:
- 工具 schema 漂移:上游工具的参数名、字段类型或枚举值变了,硬编码的
slug和arguments要么直接报错,要么静默传入错误值。 - 连接状态未知:工具调用看起来没问题,但底层授权已经过期,请求在很晚才失败。
- 会话与分页丢失:多步流程中每步都生成新 session,或者忽略响应里的分页 token,结果自然不完整。
这个技能把位置数据相关操作封装成一条固定链路:先发现工具,再确认连接,最后按返回的 schema 执行。
工作机制
核心是三个动作的固定顺序:
- 发现工具:调用
RUBE_SEARCH_TOOLS获取当前可用的 tool slug、输入 schema、推荐执行计划和已知陷阱。技能要求每次执行前都搜索一次,不允许跳过。 - 检查连接:用
RUBE_MANAGE_CONNECTIONS指定toolkit ipdata_co,确认状态为ACTIVE。若未激活,跟随返回的授权链接完成配置,再回来确认。 - 执行任务:通过
RUBE_MULTI_EXECUTE_TOOL传入发现到的 slug 执行;批量操作走RUBE_REMOTE_WORKBENCH里的run_composio_tool();带schemaRef的工具再用RUBE_GET_TOOL_SCHEMAS拉取完整 schema。
连接 Rube MCP 本身不需要 API key,只要在客户端配置里加上 https://rube.app/mcp 这个 endpoint。工具包文档位于 composio.dev/toolkits/ipdata_co。
适用边界与注意点
RUBE_MULTI_EXECUTE_TOOL的调用必须带上memory字段,即使内容是空对象{}。- 同一个工作流内复用 session ID,新建工作流再生成新的,不要在多步之间反复重建。
- 响应里出现分页 token 时要继续拉取,直到结果完整。
- 严格使用搜索结果中的字段名和类型,不要凭经验改写参数结构。
- 前置条件是 Rube MCP 已连接,且
ipdata_co工具包处于激活状态;两者缺一,就不要启动后续流程。
使用场景
- 在排查位置数据请求失败时,需要确认 Ipdata 授权是否仍处于 ACTIVE 状态。
- 要批量拉取位置数据分页结果,但不确定响应里是否还有下一页 token。
- 准备调用位置数据工具前,需要先获取最新的 tool slug 和输入 schema。
- 多步处理位置数据时,想在同一工作流内复用 session ID 避免重复创建。
适合人员
- 负责维护 MCP 工具链的工程师,需要避免硬编码 tool slug 和参数导致线上故障。
- 做数据管道的开发,经常要在上游 schema 变更后快速更新调用代码。
- 处理位置数据的分析人员,需要确保分页拉取完整再入库。
- 负责集成第三方服务的技术负责人,想在上线前验证连接状态与执行流程。