使用 Rube MCP 在 Codex 中自动化 IP2Location.io 操作从工具发现到执行的完整工作流指南【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills导读IP2Location.io 提供了基于 REST API 的 IP 地理定位、WHOIS、主机名解析等一系列网络情报能力而要让 Codex 这样的 Agent 真正把这些能力变成可执行的自动化操作关键在于一条稳定、可发现、可鉴权的工具通道。本文基于 awesome-codex-skills 仓库中的 ip2location-io-automation 技能文档完整讲解如何通过 Rube MCPComposio接入 IP2Location.io 工具包并以「工具发现 → 连接检查 → 多工具执行」的三段式工作流驱动真实调用。读完本文你将掌握 Rube MCP 的接入方法、RUBE_SEARCH_TOOLS/RUBE_MANAGE_CONNECTIONS/RUBE_MULTI_EXECUTE_TOOL等核心原语的正确用法以及规避工具 schema 漂移、连接失效、参数不合法等常见坑的实战经验。一、技能背景为什么用 Rube MCP 而不是直接调 APIIP2Location.io 官方提供 REST API开发者当然可以手写 HTTP 请求但这意味着每次都要自己处理鉴权、参数校验、错误重试与分页。而 awesome-codex-skills 这类技能仓库的价值在于把「连接第三方服务」这件事标准化。composio-skills/ip2location-io-automation/SKILL.md给出了明确的设计思路通过 Composio 的 IP2Location.io 工具包toolkitip2location_io经由 Rube MCP 暴露给 Agent。Rube MCP 是一个聚合型 MCP 端点https://rube.app/mcp它把大量已封装好的第三方集成以统一 schema 的形式提供给客户端Agent 不需要关心底层 API 细节只需按照 MCP 工具原语调用即可。从技能元数据frontmatter可以看到它的触发条件非常聚焦name: ip2location-io-automation description: Automate Ip2location IO tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube]其中requires.mcp: [rube]明确声明了该技能依赖 Rube MCP 服务器description中「Always search tools first for current schemas」是贯穿全文的第一原则——工具 schema 是动态的永远先搜索再执行。二、前置条件连接、鉴权与工具可用性在运行任何工作流之前需要满足三项前置条件Rube MCP 已连接环境中必须存在RUBE_SEARCH_TOOLS工具这是确认 Rube MCP 是否可用的标志。IP2Location.io 连接为 ACTIVE 状态通过RUBE_MANAGE_CONNECTIONS以 toolkitip2location_io建立并激活连接。先搜索后执行任何任务开始前先调用RUBE_SEARCH_TOOLS获取当前工具 schema避免使用过期的工具 slug 或参数。这三条缺一不可第一条保证通道存在第二条保证鉴权有效第三条保证调用参数与实际 schema 一致。仓库中同类的自动化技能例如 ahrefs-automation、ip2location-automation都遵循完全相同的模式可见这是 Composio 技能体系内的通用约定。注意ip2location 与 ip2location_io 是两个不同工具包仓库中同时存在composio-skills/ip2location-automation/SKILL.md与composio-skills/ip2location-io-automation/SKILL.md两个技能。前者面向传统的ip2location工具包后者面向ip2location_io工具包二者的 toolkit 名称、连接配置与可用工具 slug 各不相同。务必在连接和调用时使用与目标产品一致的 toolkit 标识混用会导致连接检查失败或工具不存在。三、环境接入一行 MCP 端点无需 API KeyRube MCP 的接入成本极低这是本技能最突出的易用性设计获取 Rube MCP在你的客户端配置中将https://rube.app/mcp添加为 MCP 服务器。无需任何 API Key——添加端点即可工作。在 Codex 中使用该技能的完整流程是将技能目录例如整个composio-skills/ip2location-io-automation/文件夹放入$CODEX_HOME/skills/默认~/.codex/skills重启 Codex 使其加载元数据然后在会话中描述任务Codex 会根据技能的description自动触发匹配。关于技能安装与使用机制的完整说明见仓库根目录 README.md 的「Using Skills in Codex」章节以及 skill-installer 技能它提供了install-skill-from-github.py等脚本用于从仓库批量安装技能。接入后按以下 4 步完成验证与建连确认 Rube MCP 可用——验证RUBE_SEARCH_TOOLS有响应调用RUBE_MANAGE_CONNECTIONS传入 toolkitip2location_io如果连接状态不是 ACTIVE按照返回的鉴权链接完成授权设置在运行任何工作流之前确认连接状态显示为 ACTIVE。四、工具发现RUBE_SEARCH_TOOLS 的正确打开方式Rube MCP 的设计哲学是「schema 即事实」。由于第三方工具包的接口可能随时调整技能文档要求在任何工作流执行之前先做工具发现。首次发现没有既有会话时使用generate_id让服务器生成会话 IDRUBE_SEARCH_TOOLS queries: [{use_case: Ip2location IO operations, known_fields: }] session: {generate_id: true}返回结果包含四类关键信息可用的工具 slugtool slugs输入 schemainput schemas即每个工具的字段名、类型与必填项推荐的执行计划recommended execution plans即完成某类任务建议的调用序列已知陷阱known pitfalls即该工具包特有的注意事项。这相当于把「查 API 文档」的环节内嵌到 Agent 工作流中Agent 每次执行前都拿到最新 schema从机制上消除了硬编码导致的调用失败。五、核心工作流模式三步调用法技能文档将整个自动化过程抽象为固定三步任何 IP2Location.io 任务都可以套用。Step 1发现可用工具复用既有会话 ID把 use_case 换成具体任务描述RUBE_SEARCH_TOOLS queries: [{use_case: your specific Ip2location IO task}] session: {id: existing_session_id}建议 use_case 尽量精确例如「查询 IP 的地理定位信息」「获取域名的 WHOIS 数据」「批量检测代理 IP」等这样返回的工具列表与执行计划才足够聚焦。Step 2检查连接执行工具前确认ip2location_io工具包的连接仍然有效RUBE_MANAGE_CONNECTIONS toolkits: [ip2location_io] session_id: your_session_id这一步能提前拦截「连接已过期/被撤销」这类问题避免在执行阶段才报错。Step 3执行工具用搜索阶段拿到的工具 slug 与 schema 合规参数发起调用RUBE_MULTI_EXECUTE_TOOL tools: [{ tool_slug: TOOL_SLUG_FROM_SEARCH, arguments: {/* schema-compliant args from search results */} }] memory: {} session_id: your_session_id注意两点tool_slug必须来自搜索结果的真实 slugarguments的字段名与类型必须严格符合搜索返回的 schema。RUBE_MULTI_EXECUTE_TOOL支持一次传入多个工具调用tools为数组因此可以在一轮内完成「查 IP → 查 WHOIS → 查域名归属」这类多步编排。六、已知陷阱清单避免 90% 的调用失败技能文档总结了 6 条高频踩坑点这里逐条展开说明其背后的原因陷阱具体表现规避方式不先搜索直接执行工具 slug 或参数已随 schema 更新而失效任何调用前先执行RUBE_SEARCH_TOOLS绝不硬编码 slug 或 arguments忽略连接状态连接过期或未授权执行阶段报鉴权错误执行前用RUBE_MANAGE_CONNECTIONS确认 ACTIVE参数不合规字段名拼写错误、类型不匹配、漏传必填项严格使用搜索结果返回的字段名与类型逐字段对照漏传 memory 参数部分客户端实现会直接拒绝调用每次RUBE_MULTI_EXECUTE_TOOL都携带memory即使为空也传{}会话滥用同一工作流内频繁新建会话丢失上下文或跨工作流复用会话造成串扰同一工作流内复用 session ID新工作流生成新 ID忽略分页只取到第一页结果数据不完整检查响应中的分页 tokenpagination tokens持续拉取直到取完全部数据其中「先搜索」与「带 memory」两条是 Rube MCP 调用层级的硬性约定其余四条属于通用 API 集成经验但在 IP2Location.io 这类数据量较大的查询场景中分页问题尤其常见——IP 情报查询往往返回成百上千条记录务必实现分页循环。七、快速参考表一张表记住全部操作操作方式查找工具RUBE_SEARCH_TOOLS传入 IP2Location.io 专属 use case建立/检查连接RUBE_MANAGE_CONNECTIONStoolkit 传ip2location_io执行工具RUBE_MULTI_EXECUTE_TOOL使用搜索发现的工具 slug批量操作RUBE_REMOTE_WORKBENCH结合run_composio_tool()使用获取完整 schema对带有schemaRef的工具调用RUBE_GET_TOOL_SCHEMAS这张表覆盖了从「找工具」到「批量执行」的完整操作面日常单步调用走前三行需要大规模、可编程的批量处理时切到RUBE_REMOTE_WORKBENCH而某些工具的 schema 较大、搜索结果只给摘要时用RUBE_GET_TOOL_SCHEMAS按schemaRef拉取完整定义。八、实战整合从技能到可落地的 Agent 自动化将本技能放入 Codex 后一个典型的端到端场景是这样的用户在会话中描述任务「分析这批 IP 的归属地并标出可疑的代理 IP」Codex 根据技能description自动加载本技能按第四节的发现流程拿到ip2location_io最新工具与执行计划按第五节的流程完成连接检查并批量执行结合分页处理完整结果汇总输出结构化报告。该技能与仓库中 connect 技能基于 Composio CLI 连接 1000 应用互为补充前者面向 Rube MCP 的 MCP 原生协议后者面向命令行工具但核心理念一致——让 Agent 不只是生成建议而是真正完成动作。若你的环境更习惯 CLI 方式也可以参考 connect 技能的composio search/composio execute模式为 IP2Location.io 建立类似的调用链。九、小结IP2Location.io 自动化技能展示了 Composio 生态中「工具包 MCP 网关 技能指令」三者配合的标准范式技能负责约定工作流顺序与纪律先搜索、再检查、后执行Rube MCP 负责统一暴露与鉴权Composio 工具包负责封装 IP2Location.io 的真实 API。对开发者而言最重要的是记住本技能反复强调的两件事schema 永远以搜索结果为准连接状态永远是执行的前提。遵循这两条纪律IP2Location.io 的 IP 情报能力就能稳定、可复现地融入任何 Codex 自动化流程。【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考