为 Agent 而造的 GEO 数据 CLI。
任何能执行 shell 命令的 Agent 都能直接驱动它：运行时发现工具、stdout 输出 JSON、确定性退出码 —— 与 MCP 服务器同一套约 61 个工具与 OAuth。单二进制自包含，人当然也能用。
The GEOly command-line interface — built for agents.
发现、查看、调用
工具名与 schema 来自服务器运行时 —— 先探测再调用。服务器可以新增工具，无需发布新 CLI。
发现你的工具
列出你账户可用的工具 —— 感知套餐与组织。
$ geoly tools --json查看工具参数
打印输入 schema，让你（或你的 Agent）知道该传什么。
$ geoly schema get_brand_overview调用
stdout 输出 JSON —— TTY 里美化，管道里紧凑。
$ geoly call get_brand_overview --time_range 30d鉴权：首次调用会打开与 MCP 服务器相同的浏览器 OAuth，然后继续执行。无头机器用 geoly auth login --no-browser 打印授权 URL；CI 里设 CI=true（或 --no-auto-auth），缺凭证时直接以退出码 3 快速失败。
完整命令面 —— 一共八条
geoly call 是唯一的执行入口，参数标志直接映射 MCP 工具 schema。其余负责发现、身份与维护。
geoly auth login [--profile <name>] [--no-browser]浏览器 OAuth 登录；--no-browser 在无头机器上打印授权 URL。
geoly auth status查看 CLI 当前将使用的凭证。
geoly auth logout清除已缓存的凭证。
geoly whoami打印当前登录身份。
geoly tools [--json] [--refresh]列出你账户可调用的工具 —— 感知套餐与组织。
geoly schema <tool>调用前打印工具的输入 schema。
geoly call <tool> [--<param> <value> …]执行工具。也接受 --data '<json>' 或 --input -（stdin）。
geoly upgrade原地更新二进制。
一个合格的 Unix 公民
stdout 是 JSON、stderr 是状态、退出码可编程 —— 无需胶水就能进管道、脚本与 CI。
接管道
TTY 里美化输出，进管道自动紧凑。
$ geoly call get_brand_overview --time_range 30d | jq .喂 JSON
用一个 JSON 传全部参数，替代逐个标志。
$ geoly call get_brand_overview --data '{"time_range":"30d"}'按退出码分支
鉴权与限流是可脚本化的不同失败。
$ geoly call get_brand_overview --time_range 30dcase $? in 3) geoly auth login ;; 4) sleep 60 ;;esac把终端交给你的 Agent
这个 CLI 天生就是给 AI Agent 开的，不只给人用 —— 任何能执行 shell 命令的 Agent 都能用它查询 GEOly。
运行时发现，绝不硬编码
Agent 在运行时用 geoly tools --json 探测工具面，服务器新增工具也不会弄坏它 —— 没有过期的工具清单。
一切皆机器可读
stdout 输出 JSON，--error-format json 给出结构化错误，退出码可供 Agent 分支判断。
鉴权不进循环
你在浏览器里授权一次，凭证由 CLI 缓存。Agent 只管跑命令 —— 从不接触任何密钥。
这个月我们品牌在各 AI 引擎上表现怎么样？
我用 GEOly 查一下。
查好了 —— 30 天总览：提及率、引用与 Share of Model，已按引擎拆好。
随附 geoly-mcp Agent 技能 —— 教你的 Agent 每类问题该用哪个工具、引用正确的 KPI 口径。
获取技能脚本可以信赖的契约
标志、输出行为与退出码是稳定面 —— 为 Agent 和流水线设计，不只是给人用。
- STABILITY
- 稳定契约
v0 冻结了标志、输出与退出码。工具名来自服务器运行时 —— 调用前先 geoly tools --json。
- OUTPUT
- stdout 是数据，stderr 是状态
结果以 JSON 走 stdout。--error-format json 输出机器可读的错误对象（kind、status、retryAfter、hint）。
- EXIT CODES
- 可编程的退出码
0 成功 · 1 工具错误 · 2 用法 · 3 鉴权 · 4 限流 · 5 订阅 · 6 上游。
- WRITES
- 默认只读
v0 只读。写入类工具将在后续版本推出，且需显式确认标志。Agent 技能随仓库一起分发。
- AUTOMATION
- 可限定、可脚本化的会话
--org <id> 锁定单一组织；--profile <name> 区分多账户；CI=true / --no-auto-auth 缺凭证即快速失败（退出码 3）；限流错误附带 retryAfter。
CLI 还是 MCP 服务器
脚本、CI、cron 与管道
就是这里 —— 装上 CLI，在终端里驱动这些工具。
在 Claude、Cursor、Codex 里
改连 MCP 服务器 —— 同一套约 61 个工具，零安装。
同一套工具、同一套指标、同一个 OAuth —— 按场景选，随意混用。
CLI 问答
不需要。安装器只往 ~/.local/bin 放一个自包含二进制 —— 无 Node、无 Python、无 sudo。支持：macOS（arm64/x64）与 Windows（x64）。