Claude Skill

Work with your Vizzybl GEO data — Share of Voice, monitored prompts, the actual AI answers, and citations — directly inside Claude. The Vizzybl skill teaches Claude to call the Vizzybl public API, so you can ask questions in plain language instead of opening a dashboard.

Vizzybl covers Claude natively, alongside ChatGPT, Gemini, Perplexity, and Google AI Overviews.

Before you begin

You need:

• An Ultra or Enterprise plan — API access is available on these tiers.
• The owner or admin role in your workspace, to create keys.
• Claude Code, the Claude desktop app, or any Claude surface that supports Agent Skills.

Step 1: Create an API key

1. Open Settings → API Keys.
2. Click Create API key, name it (for example, "Claude skill"), and choose scopes. All read access is the simplest starting point.
3. Copy the key immediately. It starts with vzbl_live_ and is shown only once — store it like a password.

You can revoke a key at any time from the same screen. Revocation takes effect immediately.

Step 2: Add the skill

The skill is a folder — SKILL.md plus a full references/api-reference.md and an openapi.json spec. How you add it depends on where you use Claude.

⬇ Download the packaged skill (.zip)

Claude Code. Put the folder in your skills directory, or install the plugin:

• Every project: ~/.claude/skills/vizzybl-geo/
• One project: .claude/skills/vizzybl-geo/

/plugin install vizzybl-geo

Claude Desktop or claude.ai. Upload the skill .zip under Settings → Features → Skills (Pro, Max, Team, or Enterprise). The skill calls the Vizzybl API, so it only works where Claude has network access — enable network access for skills in your workspace. Skills on the Claude API surface have no network access and can't reach the API.

Because the skill calls the Vizzybl API, claude.ai must be allowed to reach it. In your Claude settings:

1. Turn on Allow network egress (it may already be enabled for your workspace).
2. Under Domain allowlist → Additional allowed domains, add vizzybl.ai and click Add.

Without this, the skill's requests fail with a network / connection error.

Step 3: Set your API key

The skill reads your key from the VIZZYBL_API_KEY environment variable:

export VIZZYBL_API_KEY="vzbl_live_..."

If it isn't set, Claude asks for it once and uses it for the session.

Step 4: Ask a question

With the skill added and the key set, ask in plain language:

• "How is my brand doing in AI search over the last 90 days?"
• "What did ChatGPT and Claude actually say about us for our top prompts?"
• "Which competitor domains get cited where we don't?"

Claude calls the API, paginates when there is more data, and summarizes the results — grouped by engine when you compare answers.

What you can query

Area	Endpoint
Snapshot + trend	/api/v1/stats, /api/v1/visibility
Monitored prompts	/api/v1/prompts
Verbatim AI answers	/api/v1/prompt-responses
Cited domains	/api/v1/citations
Reverse citation lookup	/api/v1/citations/prompts

The API is read-only, and every key is scoped to a single workspace. The full endpoint reference, parameters, and response shapes are in the references/api-reference.md file bundled with the skill.

Security

• Treat keys like passwords — anyone with a key can read your workspace's GEO data.
• Keys are read-only and cannot change settings or spend credits.
• Revoke a key the moment it is no longer needed, or if it may have leaked.
• Keys are disabled automatically if your plan drops below Ultra.

Troubleshooting

• 401 — the key is missing, revoked, expired, or malformed. Re-check VIZZYBL_API_KEY.
• 403 — the key lacks the scope for that data, or the plan is no longer Ultra or Enterprise.
• 429 — you are being rate limited. Wait and retry; Claude honors the retry delay automatically.