ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

awesome-claude-skills 实战:使用 Rube MCP 通过 Composio 自动化 Geokeo 地理位置任务

awesome-claude-skills 实战:使用 Rube MCP 通过 Composio 自动化 Geokeo 地理位置任务 AI 技能AI 插件人工智能工作流自动化【免费下载链接】awesome-claude-skillsA curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows项目地址https://gitcode.com/GitHub_Trending/aw/awesome-claude-skills点击查看免费下载导读awesome-claude-skills 仓库的composio-skills/目录收录了 78 个面向具体 SaaS 应用的开箱即用工作流 Skill见 README 的 App Automation via Composio 章节本文聚焦其中的 Geokeo 自动化 Skill。这篇指南将带你掌握如何在 Claude 等 Agent 中接入 Rube MCP、如何通过RUBE_MANAGE_CONNECTIONS建立并确认 Geokeo 连接、如何先用RUBE_SEARCH_TOOLS发现当前工具 Schema、以及如何用RUBE_MULTI_EXECUTE_TOOL执行 Geokeo 操作——读完即可直接落地地理编码、逆地理编码等地理位置类任务的自动化流程。什么是 Geokeo Automation Skillgeokeo-automation是一个预构建的 Claude Skill用于通过 Composio 的 Geokeo toolkit 自动化 Geokeo 相关操作。Skill 本体只有一份 SKILL.md 文件其 YAML 头信息frontmatter定义如下--- name: geokeo-automation description: Automate Geokeo tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---这段元数据是 Claude Skills 开放标准的组成部分name是 Skill 名称description是 Agent 在会话启动时看到的摘要约 100 token用于判断该 Skill 是否与当前任务相关requires.mcp声明本 Skill 依赖名为rube的 MCP 服务器即 Rube MCP。这意味着该 Skill 不直接调用 Geokeo 的 HTTP API而是通过 Rube MCP 这层连接器将 Composio 平台上的 Geokeo 工具暴露给 Agent 调用。前置条件与连接建立在运行任何 Geokeo 工作流之前需要满足以下前置条件依据 SKILL.md 的 Prerequisites 小节Rube MCP 已连接RUBE_SEARCH_TOOLS可用通过RUBE_MANAGE_CONNECTIONS建立了 toolkit 为geokeo的活动连接Active connection任何操作前必须先调用RUBE_SEARCH_TOOLS获取当前工具 Schema。Rube MCP 接入方式Rube MCP 的接入非常轻量在客户端如 Claude Code的 MCP 配置中添加端点https://rube.app/mcp即可无需预先申请 API Key——加入端点即可工作。这正是该 Skill 开箱即用的关键认证由 Composio/Rube 侧统一托管。建立 Geokeo 连接的四个步骤1. 确认 Rube MCP 可用验证 RUBE_SEARCH_TOOLS 能正常响应 2. 调用 RUBE_MANAGE_CONNECTIONStoolkit 参数传入 geokeo 3. 若连接状态不是 ACTIVE按返回的 auth 链接完成授权设置 4. 在任何工作流运行前确认连接状态为 ACTIVE第 2 步的调用形式如下RUBE_MANAGE_CONNECTIONS toolkits: [geokeo] session_id: your_session_id这里传入的session_id会贯穿后续所有工具调用用于在同一工作流内维持上下文新工作流应生成新的 session_id。工具发现永远先搜索 SchemaGeokeo 的工具集并非一成不变Composio 会持续更新 toolkit工具 slug、参数名、字段类型都可能变化。因此 Skill 的核心纪律是——绝不硬编码工具 slug 或参数每次执行前先调用RUBE_SEARCH_TOOLS。第一次发现工具的推荐调用RUBE_SEARCH_TOOLS queries: [{use_case: Geokeo operations, known_fields: }] session: {generate_id: true}use_case用自然语言描述你的 Geokeo 任务场景known_fields如果你已了解某些字段可提前告知不确定时留空session.generate_id: true让本次搜索自动生成会话 ID。该调用会返回可用的工具 slug、输入 Schema、推荐的执行方案recommended execution plans以及已知的坑known pitfalls。这正是后续构造RUBE_MULTI_EXECUTE_TOOL参数的唯一事实来源。核心工作流三阶段模式Step 1发现可用工具针对你的具体 Geokeo 任务发起搜索复用已有 sessionRUBE_SEARCH_TOOLS queries: [{use_case: your specific Geokeo task}] session: {id: existing_session_id}例如你要做地址转坐标use_case可以写geocode an address to lat/lng要写批量逆地理编码就写对应场景。返回结果中的tool_slug和arguments结构将直接用于 Step 3。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [geokeo] session_id: your_session_id确认返回的连接状态为ACTIVE后再继续。这一步相当于执行前的“保险丝”连接过期或未授权时任何工具调用都会失败提前检查可以避免无谓的重试。Step 3执行工具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必须来自 Step 1 搜索结果的真实 slug不能凭记忆填写arguments必须严格遵循搜索返回的 Schema——字段名、类型、必填项都要一致memory参数必须始终携带即使为空也要传{}同一工作流内复用同一个session_id。批量操作与完整 Schema除标准执行路径外Quick Reference 还提供了两种进阶方式操作方式查找工具用 Geokeo 相关 use case 调用RUBE_SEARCH_TOOLS连接用 toolkitgeokeo调用RUBE_MANAGE_CONNECTIONS执行用发现到的工具 slug 调用RUBE_MULTI_EXECUTE_TOOL批量操作用RUBE_REMOTE_WORKBENCH配合run_composio_tool()完整 Schema对含schemaRef的工具调用RUBE_GET_TOOL_SCHEMAS当单个工具返回的 Schema 引用了外部schemaRef如嵌套对象定义时需用RUBE_GET_TOOL_SCHEMAS拉取完整定义而需要批量处理如对一批地址循环执行地理编码时可改用RUBE_REMOTE_WORKBENCH在远端工作台内通过run_composio_tool()编写循环逻辑避免反复发起多轮会话。已知陷阱清单Known Pitfalls这份 Skill 的价值很大一部分来自对实际使用踩坑经验的沉淀共 6 条务必逐条对照永远先搜索工具 Schema 会变化。未调用RUBE_SEARCH_TOOLS就硬编码工具 slug 或参数是最大的失败来源。检查连接执行工具前必须确认RUBE_MANAGE_CONNECTIONS显示ACTIVE状态。Schema 合规参数必须使用搜索结果中的精确字段名和类型多一个、少一个、写错类型都会导致调用失败。memory 参数所有RUBE_MULTI_EXECUTE_TOOL调用都必须包含memory即使为空也要传{}。会话复用同一工作流内复用 session ID新工作流才生成新的。分页处理检查响应中的分页 token持续翻页直到数据取完否则会漏掉部分结果。在仓库中的定位与扩展阅读在 README.md 的“App Automation via Composio”章节中geokeo-automation与 Close、HubSpot、Salesforce、Google Maps 等 78 个应用的自动化 Skill 并列README.md#L222-L224它们共享同一套 Rube MCP 调用范式。因此掌握本 Skill 的三阶段工作流搜索 → 检查连接 → 执行后可以几乎零成本迁移到其他 Skill例如同为地理位置主题的 google-maps-automation 展示了更完整的工具参数如GOOGLE_MAPS_TEXT_SEARCH的textQuery、GOOGLE_MAPS_GET_ROUTE的travelMode枚举等可以作为理解“搜索返回 Schema 形态”的参考样本两者都遵循“先搜索、再连接、后执行”的统一纪律。从更宏观的视角看这正是 README 中关于 Claude Skills 的定位所强调的分层协作MCP 负责访问auth、transport、工具发现工具负责动作Skill 负责行为做什么、按什么顺序、带什么护栏。geokeo-automation就是“行为层”的典型代表——它不包含任何 Geokeo 的具体代码实现而是把正确的调用顺序、参数纪律和踩坑经验固化成了可被 Agent 按需加载的指令包。本文基于 awesome-claude-skills 仓库中的 composio-skills/geokeo-automation/SKILL.md 编写所有命令、参数与陷阱均忠实于该文档原文。赞分享AI 技能AI 插件人工智能工作流自动化【免费下载链接】awesome-claude-skillsA curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows项目地址https://gitcode.com/GitHub_Trending/aw/awesome-claude-skills点击查看免费下载相关推荐awesome-claude-skills 实战通过 Rube MCPComposio自动化 Adrapid 运营任务awesome claude skills 实战通过 Rube MCPComposio自动化 Adrapid 运营任务 在 Claude Skills 生AI 技能AI 插件人工智能工作流自动化awesome-claude-skills 实战通过 Rube MCPComposio自动化 Appointo 预约调度任务awesome claude skills 实战通过 Rube MCPComposio自动化 Appointo 预约调度任务 本文是 awesome clAI 技能AI 插件人工智能工作流自动化awesome-claude-skills 实战通过 Rube MCP 自动化 Bugbug 任务Composio 集成指南awesome claude skills 实战通过 Rube MCP 自动化 Bugbug 任务Composio 集成指南 导读 本文基于 awesomAI 技能AI 插件人工智能工作流自动化上一篇终极解决方案3种在Apple Silicon Mac上运行Vivado的高效方法下一篇如何优化Firebase JobDispatcher性能7个实用技巧与最佳实践指南 创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表