awesome-codex-skills 实战通过 Rube MCP 自动化 Google Maps地理编码、路线规划、地点搜索与距离矩阵【免费下载链接】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本指南以 awesome-codex-skills 仓库中的 google_maps-automation 技能 为骨架完整讲解如何让 Codex 通过 Rube MCP 调用 Composio 的 Google Maps 工具包实现地址地理编码、地点搜索、路线与距离计算、地点详情获取等真实操作。读完本文你将掌握工具发现—连接管理—多工具执行—批量处理的完整技能使用流程并了解每个核心工具的参数细节、常见陷阱与仓库内的安装方式。技能总览这份 SKILL.md 解决什么问题该技能文件是一份标准的 Codex Skill其 frontmatter 声明如下--- name: google_maps-automation description: Automate Google Maps tasks via Rube MCP (Composio): geocoding, directions, place search, and distance calculations. Always search tools first for current schemas. requires: mcp: [rube] ---从声明可以看出它的定位通过 Rube MCP 封装 Composio 的 Google Maps 工具包让 Codex 在对话中直接完成地理编码、路线规划、地点搜索和距离计算等任务而不是只输出建议文本。description字段中的Always search tools first是贯穿全文的第一原则——工具 schema 会随版本变化绝不能硬编码工具名。值得注意的是仓库中还保留了一份更细化的兄弟版本 google-maps-automation/SKILL.md它列出了GOOGLE_MAPS_GEOCODING_API、GOOGLE_MAPS_TEXT_SEARCH、GOOGLE_MAPS_GET_ROUTE、GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX、GOOGLE_MAPS_NEARBY_SEARCH、GOOGLE_MAPS_GET_PLACE_DETAILS等工具的完整参数本文在介绍核心操作时将以两版文档相互印证给出更可落地的参数说明。前置条件在使用本技能前需要满足三个条件Rube MCP 已连接确认RUBE_SEARCH_TOOLS可用Google Maps 连接已激活通过RUBE_MANAGE_CONNECTIONS建立 toolkit 为google_maps的连接始终先调用RUBE_SEARCH_TOOLS获取当前最新的工具 schema再决定后续动作。这三条的本质是先保证传输通道MCP就绪再保证业务授权Google Maps 账号连接有效最后用运行时发现替代静态假设。环境搭建接入 Rube MCP 并激活 Google Maps 连接添加 Rube MCP 服务端在 Codex 客户端配置中把https://rube.app/mcp添加为 MCP server 即可无需任何 API Key——只需添加端点即可工作。这与仓库中其他 Rube MCP 系技能如 -21risk-automation的接入方式完全一致属于该系列技能的统一入口。四步激活流程验证 Rube MCP 可用确认RUBE_SEARCH_TOOLS有正常响应发起连接调用RUBE_MANAGE_CONNECTIONStoolkit 参数传google_maps完成授权若连接状态不是 ACTIVE按照返回的 auth link 完成 OAuth 设置确认就绪在运行任何工作流之前确认连接状态显示为 ACTIVE。授权走的是 Google 的标准 OAuth 流程一次授权后连接持久生效过期后需重新走RUBE_MANAGE_CONNECTIONS完成再认证见下文错误处理。工具发现一切执行的起点技能文档反复强调一个动作——执行任何工作流前先发现可用工具。标准调用示例如下RUBE_SEARCH_TOOLS: queries[{use_case: geocoding, directions, place search, and distance calculations, known_fields: }]该调用会返回四类信息Google Maps 相关的可用工具 slug 列表推荐的执行计划步骤已知的陷阱与边界情况每个工具的输入 schema。对应到该系列技能的通用流程google-maps-automation 兄弟文档 还展示了带session的调用变体generate_id: true或复用既有session.id用于在同一工作流内维持会话上下文。核心工作流工作流一发现可用的 Google Maps 工具RUBE_SEARCH_TOOLS: queries: - use_case: list all available Google Maps tools and capabilities返回结果后先审阅工具清单、描述与输入 schema再进行下一步避免调用不存在的工具或传错参数。工作流二执行 Google Maps 操作工具发现完成后通过RUBE_MULTI_EXECUTE_TOOL执行RUBE_MULTI_EXECUTE_TOOL: tools: - tool_slug: discovered_tool_slug arguments: {schema-compliant arguments} memory: {} sync_response_to_workbench: false要点tool_slug必须来自搜索发现的结果arguments必须严格符合 schemamemory参数即使为空也要带上{}这是该系列技能的通用约定-21risk-automation 文档中同样强调这一点。工作流三多步组合工作流对于涉及多次 Google Maps 操作的复杂流程按以下顺序编排用RUBE_SEARCH_TOOLS按具体 use case 搜索所有相关工具先执行前置步骤例如先 fetch 再 update通过工具响应在步骤间传递数据大批量操作或数据处理交给RUBE_REMOTE_WORKBENCH。六大核心操作详解结合兄弟文档的参数说明各核心工具的可传递参数如下实际以RUBE_SEARCH_TOOLS返回的当前 schema 为准1. 地址地理编码 ——GOOGLE_MAPS_GEOCODING_API把街道地址转换为经纬度坐标address待地理编码的街道地址或 plus codelatlng反查时使用的经纬度如40.714224,-73.961452place_id按地点 ID 做地理编码language结果语言region区域偏置ccTLD 国家码bounds视口偏置的边界框components组件过滤如postal_code:94043|country:US。2. 地点文字搜索 ——GOOGLE_MAPS_TEXT_SEARCH用自由文本查找地点textQuery必填搜索文本如restaurants in LondonfieldMask指定返回字段如displayName,formattedAddress,ratingmaxResultCount最大结果数1–20默认 10。3. 两点间路线规划 ——GOOGLE_MAPS_GET_ROUTE计算带距离与耗时信息的路线origin_address必填起点地址或lat,lngdestination_address必填终点地址或lat,lngtravelModeDRIVE、BICYCLE、WALK、TWO_WHEELER或TRANSITroutingPreferenceTRAFFIC_UNAWARE、TRAFFIC_AWARE、TRAFFIC_AWARE_OPTIMALcomputeAlternativeRoutes是否返回备选路线布尔值unitsMETRIC或IMPERIALlanguageCodeBCP-47 语言代码routeModifiers_avoidTolls/avoidHighways/avoidFerries路线偏好开关。4. 距离矩阵 ——GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX一次性计算多个起点与终点间的距离和耗时origins必填起点数组地址字符串或 lat/lng 对象destinations必填终点数组travelMode同上五种模式routingPreference同上fieldMask指定返回字段unitsMETRIC或IMPERIAL。5. 地点详情 ——GOOGLE_MAPS_GET_PLACE_DETAILS按资源名places/{place_id}格式获取地点的营业时间、联系方式、评论等完整信息。文档明确提示调用前需通过RUBE_SEARCH_TOOLS获取该工具的完整 schema。6. 周边搜索 ——GOOGLE_MAPS_NEARBY_SEARCH在圆形区域内查找地点latitude必填中心纬度-90 到 90longitude必填中心经度-180 到 180radius必填搜索半径米最大 50000includedTypes包含的地点类型如[restaurant, cafe]excludedTypes排除的地点类型fieldMask指定返回字段maxResultCount最大结果数1–20。常用模式先地理编码、再规划路线用GOOGLE_MAPS_GEOCODING_API把地址转成坐标再用GOOGLE_MAPS_GET_ROUTE计算两点间路线先搜索、再取详情用GOOGLE_MAPS_TEXT_SEARCH找到地点再用GOOGLE_MAPS_GET_PLACE_DETAILS获取营业时间、联系方式、评论等富元数据自动补全交互用GOOGLE_MAPS_AUTOCOMPLETE实现用户输入时的即时联想建议反向地理编码用GOOGLE_MAPS_GEOCODE_LOCATION把坐标还原为可读地址批量距离计算多对多距离场景用GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX而不是反复调用GOOGLE_MAPS_GET_ROUTE地图嵌入用GOOGLE_MAPS_MAPS_EMBED_API生成地点、路线或搜索结果的可嵌入地图 URL。通用防御性模式Search Before Action创建新资源前先搜索既有资源避免重复分页处理许多列表类操作支持分页检查响应中的next_cursor或page_token持续拉取直到取完错误处理执行前检查工具响应中的错误工具失败时先确认连接仍为 ACTIVE连接过期则通过RUBE_MANAGE_CONNECTIONS重新认证批量操作在RUBE_REMOTE_WORKBENCH中用run_composio_tool()配合ThreadPoolExecutor循环实现并行执行。已知陷阱务必逐条核对永远先搜索工具工具 schema 与可用操作可能变化。未经RUBE_SEARCH_TOOLS发现就硬编码 tool slug 是最大的错误来源检查连接状态执行任何工具前确保 Google Maps 连接为 ACTIVE过期的 OAuth token 需要重新认证遵守速率限制收到限流错误时降低请求频率并实现退避backoff校验 schema始终传递严格符合 schema 的参数当返回的是schemaRef而非input_schema时用RUBE_GET_TOOL_SCHEMAS加载完整输入 schema距离矩阵的返回结构GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX的结果位于data.elements下通过originIndex、destinationIndex配合distanceMeters、duration读取而不是routes[]结构耗时格式GOOGLE_MAPS_GET_ROUTE返回的 duration 是形如937s的字符串位于data.response_data.routes数值比较前必须先解析串联时的 Place ID调用GOOGLE_MAPS_GET_PLACE_DETAILS时使用GOOGLE_MAPS_TEXT_SEARCH返回的地点标识符才能取到更丰富的字段反向地理编码的输入GOOGLE_MAPS_GEOCODE_LOCATION是坐标驱动的必须传 lat/lng 而非地址字符串否则查询会错位路线偏好限制routingPreference在travelMode为 WALK、BICYCLE、TRANSIT 时不能设置必须省略该参数周边搜索类型合法性food不是GOOGLE_MAPS_NEARBY_SEARCH的合法类型它属于 Table B应使用restaurant、cafe、bakery、fast_food_restaurant等具体类型嵌入 API 只支持 API KeyGOOGLE_MAPS_MAPS_EMBED_API需要 API Key不支持 OAuth2。快速参考表操作工具关键参数地址地理编码GOOGLE_MAPS_GEOCODING_APIaddress或latlng或place_id反向地理编码GOOGLE_MAPS_GEOCODE_LOCATION完整 schema 见RUBE_SEARCH_TOOLS文字搜索GOOGLE_MAPS_TEXT_SEARCHtextQuery、fieldMask、maxResultCount周边搜索GOOGLE_MAPS_NEARBY_SEARCHlatitude、longitude、radius、includedTypes路线规划GOOGLE_MAPS_GET_ROUTEorigin_address、destination_address、travelMode距离矩阵GOOGLE_MAPS_COMPUTE_ROUTE_MATRIXorigins、destinations、travelMode地点详情GOOGLE_MAPS_GET_PLACE_DETAILS完整 schema 见RUBE_SEARCH_TOOLS自动补全GOOGLE_MAPS_AUTOCOMPLETEinput、includedRegionCodes、locationBias地点照片GOOGLE_MAPS_PLACE_PHOTO完整 schema 见RUBE_SEARCH_TOOLS地图嵌入GOOGLE_MAPS_MAPS_EMBED_APImode及模式相关参数流程层面的操作速查操作方式查找工具RUBE_SEARCH_TOOLS Google Maps 相关的 use case建立连接RUBE_MANAGE_CONNECTIONS toolkitgoogle_maps执行工具RUBE_MULTI_EXECUTE_TOOL 发现的 tool slug批量操作RUBE_REMOTE_WORKBENCHrun_composio_tool()获取完整 schemaRUBE_GET_TOOL_SCHEMAS针对返回schemaRef的工具如何把该技能安装进 Codex该技能属于仓库中 composio-skills 目录下 Rube MCP 系列技能之一requires: mcp: [rube]安装方式遵循仓库 README 的通用流程。按 README.md 的说明技能存放在$CODEX_HOME/skills默认~/.codex/skills每个子目录需包含带name和descriptionfrontmatter 的SKILL.md安装或更新后需重启 Codex 以加载新元数据在会话中自然描述任务即可触发匹配的技能。推荐使用仓库自带的 skill-installer 完成安装git clone https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills.git cd awesome-codex-skills python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/google_maps-automation该安装器会把技能放置到$CODEX_HOME/skills/skill-name脚本支持--ref默认main、--dest、--method auto|download|git等选项并在目标目录已存在时中止避免覆盖。安装完成后重启 Codex即可在会话中让 Codex 借助RUBE_SEARCH_TOOLS→RUBE_MANAGE_CONNECTIONS→RUBE_MULTI_EXECUTE_TOOL的链路真正执行 Google Maps 操作。如果你更习惯命令行方式管理连接仓库中的 connect 技能 展示了另一条路径通过composio link建立 OAuth 连接、composio search发现工具、composio execute执行动作与本技能的 MCP 路线互为补充。【免费下载链接】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），仅供参考