Geomanic 技能

该技能通过连接 Geomanic MCP API，实现旅行统计数据查询、航点管理及行程分析。

身份认证

API 密钥存储在环境变量 GEOMANIC_TOKEN 中。所有请求均需将其作为 Bearer Token 提交。

如何调用 API

使用 exec 工具执行 curl 命令，向 https://geomanic.com/api/v1/mcp 发送 JSON-RPC 请求：

curl -s -X POST https://geomanic.com/api/v1/mcp 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $GEOMANIC_TOKEN" 
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"TOOL_NAME","arguments":{...}}}'

可用工具

get_statistics

获取指定时间范围内的聚合旅行统计数据。返回总距离（km）、平均/最高速度（km/h）、海拔高度、航点数量、活跃天数，以及按国家划分的完整天数与部分天数统计。

必需参数：from（ISO 8601 格式），to（ISO 8601 格式）。 可选参数：suppress_flights（布尔值，默认为 true）。

示例：

curl -s -X POST https://geomanic.com/api/v1/mcp 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $GEOMANIC_TOKEN" 
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_statistics","arguments":{"from":"2026-02-22T00:00:00Z","to":"2026-02-22T23:59:59Z"}}}'

get_date_range

获取用户最早和最晚航点的时间戳。无需任何参数。

curl -s -X POST https://geomanic.com/api/v1/mcp 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $GEOMANIC_TOKEN" 
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_date_range","arguments":{}}}'

list_waypoints

列出航点，支持可选的时间范围、分页及排序。

可选参数：from、to（ISO 8601 格式），limit（默认为 50，最大为 200），offset（默认为 0），order（取值为 "asc" 或 "desc"，默认为 "desc"）。

curl -s -X POST https://geomanic.com/api/v1/mcp 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer $GEOMANIC_TOKEN" 
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_waypoints","arguments":{"from":"2026-02-22T00:00:00Z","to":"2026-02-22T23:59:59Z","limit":10}}}'

get_waypoint

根据 UUID 获取单个航点。

必需参数：id（字符串，UUID）。

create_waypoint

创建一个新的 GPS 航点。

必需参数：timestamp_utc（ISO 8601 格式），latitude（数值），longitude（数值）。 可选参数：speed_kmh、altitude、heading_deg、device_id。

update_waypoint

根据 UUID 更新已有航点。

必需参数：id（字符串，UUID）。 可选参数：latitude、longitude、speed_kmh、altitude、heading_deg、country_iso、place、device_id。

delete_waypoint

根据 UUID 删除一个航点。

必需参数：id（字符串，UUID）。

重要说明

• 所有日期必须采用带时区的 ISO 8601 格式（建议使用 UTC 并以 Z 作为后缀）。
• 若需查询“今日”数据，请使用当前日期，并将时间范围设为 T00:00:00Z 至 T23:59:59Z。
• 响应格式为 JSON-RPC；实际数据位于 result.content[0].text 字段中，其值为 JSON 字符串。
• 距离单位为千米（km），速度单位为千米每小时（km/h），海拔单位为米（m）。