{"_id":"@adgine/geo-cli","name":"@adgine/geo-cli","dist-tags":{"latest":"1.2.8"},"versions":{"1.2.8":{"name":"@adgine/geo-cli","publishConfig":{"access":"public"},"version":"1.2.8","description":"Adgine GEO skills as a CLI — run the full adgine-geo skill suite from your terminal or install them into an AI agent. Wraps the Python skills; bring your own GEO_API_KEY.","keywords":["adgine","geo","aeo","ai-visibility","cli","skills","ai-agent","generative-engine-optimization"],"homepage":"https://platform.adgine.ai","license":"MIT","type":"commonjs","bin":{"adgine-geo":"bin/adgine-geo.js"},"scripts":{"sync-skills":"node scripts/sync-skills.js","sync-version":"node scripts/sync-version.js","prepublishOnly":"node scripts/sync-skills.js && node scripts/sync-version.js"},"engines":{"node":">=18"},"_id":"@adgine/geo-cli@1.2.8","_nodeVersion":"24.14.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-2j8y+V8CRxqqMz1jcrbSNlvA25It/DaYgKhNoVKEIT9DOGs726q7AZHSiZ5aoDDDxvAPXCDMqgzIJvGxkYrKCw==","shasum":"2d4e59d5207b421a6ee287752cab977f8a213e97","tarball":"https://registry.npmjs.org/@adgine/geo-cli/-/geo-cli-1.2.8.tgz","fileCount":115,"unpackedSize":958427,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHZBWSy7zr0RQxhfdGDHD1ZIcl4yK9TKWawVz9F6rYqBAiEA2L2/D5ZiQN2MqSQjlQQPxkJcDb0LQp9THFlmKHrjjqs="}]},"_npmUser":{"name":"lipert","email":"thunder54007@gmail.com"},"directories":{},"maintainers":[{"name":"lipert","email":"thunder54007@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/geo-cli_1.2.8_1783404407403_0.402418515325746"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-07T06:06:47.271Z","1.2.8":"2026-07-07T06:06:47.559Z","modified":"2026-07-07T06:06:47.788Z"},"maintainers":[{"name":"lipert","email":"thunder54007@gmail.com"}],"description":"Adgine GEO skills as a CLI — run the full adgine-geo skill suite from your terminal or install them into an AI agent. Wraps the Python skills; bring your own GEO_API_KEY.","homepage":"https://platform.adgine.ai","keywords":["adgine","geo","aeo","ai-visibility","cli","skills","ai-agent","generative-engine-optimization"],"license":"MIT","readme":"# @adgine/geo-cli\n\nRun the **Adgine GEO skill suite** from your terminal — or install the skills into an\nAI agent (Claude Code, Cursor, …). This is a thin Node wrapper over the official\n`adgine-geo-skills` Python scripts, published to npm so you can `npm i -g` instead of\ncloning a repo. Bring your own `GEO_API_KEY`.\n\n## Requirements\n\n- **Node.js ≥ 18**\n- **Python ≥ 3.9** on your PATH (the CLI wraps Python skills)\n- A **GEO API key** (`geo_sk_live_…`) from <https://platform.adgine.ai>\n\n## Install\n\n```bash\nnpm install -g @adgine/geo-cli\n# or run without installing:\nnpx @adgine/geo-cli --help\n```\n\n## Quick start\n\n```bash\n# 1. Save your key once (stored in ~/.adgine/config.json, mode 0600)\nadgine-geo config set-key geo_sk_live_xxxxxxxx\n\n# 2. Check your environment (Python, key validity, optional deps)\nadgine-geo doctor\n\n# 3. Explore what's available\nadgine-geo list\n\n# 4. Run a skill action\nadgine-geo projects list_projects\nadgine-geo visibility get_visibility score --project-id <id>\n```\n\nThe key is passed to the Python scripts via the environment at run time — no `.env`\nfile is written into the package, and nothing is added to your shell rc files.\n\n## Usage\n\n```\nadgine-geo <skill> <action> [options]    Run a skill action (options pass through to Python)\nadgine-geo list                          List all skills and their actions\nadgine-geo <skill>                       Show a skill's actions\nadgine-geo <skill> <action> --help       Show a script's own options (argparse)\nadgine-geo doctor [--install-audit-deps] Check Python, API key, and optional deps\nadgine-geo config set-key <key>          Save GEO_API_KEY\nadgine-geo config set-base-url <url>     Override the API base URL (self-hosted)\nadgine-geo config get                    Show current config (key masked)\nadgine-geo config path                   Print the config file path\nadgine-geo skills install [--target d]   Install the skills into an AI agent's skills dir\nadgine-geo --version                     Print version\n```\n\nConfiguration precedence: environment variables (`GEO_API_KEY`, `GEO_API_BASE_URL`)\noverride `~/.adgine/config.json`.\n\n## Using it with an AI agent\n\n`adgine-geo skills install` copies the skill folders into an agent's skills directory\n(the same layout the agent would get from a git clone) and writes your key into a local\n`.env` there:\n\n```bash\nadgine-geo skills install --target ~/.claude/skills/adgine-geo\n```\n\nWith no `--target`, it installs to the default Claude Code user skills directory and\nprints other common locations.\n\n## Skills that don't need a key\n\n- **`site-audit`** — standalone GEO technical audit of any public URL (local crawl + PDF).\n  Needs a few extra Python packages: `adgine-geo doctor --install-audit-deps`.\n- **`docs`** — links the official Adgine user manual.\n\n## How it works\n\n```\nadgine-geo (Node bin)\n  └─ spawns python3 skills/adgine-geo-<skill>/scripts/<action>.py <args...>\n     with GEO_API_KEY injected into the child environment\n```\n\nThe `skills/` payload is the upstream `adgine-geo-skills` suite, bundled at publish\ntime. The npm package version tracks the suite's `VERSION`.\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-70d5c4ac742dae5d1f6137e1fbe6ac39"}