audigeo-mcp 0.1.2__tar.gz

audigeo_mcp-0.1.2/.gitignore

@@ -0,0 +1,11 @@
+# Build artifacts — produced by mcp/build/*.sh, recreated by CI
+dist/
+*.egg-info/
+__pycache__/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.venv/
+
+# Editor scratch
+.DS_Store

audigeo_mcp-0.1.2/PKG-INFO

@@ -0,0 +1,167 @@
+Metadata-Version: 2.4
+Name: audigeo-mcp
+Version: 0.1.2
+Summary: AudiGEO MCP server — exposes AudiGEO.ai capabilities (audits, monitoring, hallucinations, content) to MCP-compatible agents.
+Author-email: Sponge Theory <support@audigeo.ai>
+License: SPONGE THEORY PROPRIETARY LICENSE
+Keywords: ai-monitoring,audigeo,claude,geo,mcp,sponge-theory
+Requires-Python: >=3.10
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: mcp[cli]>=1.2.0
+Requires-Dist: pydantic-settings<3,>=2.2
+Requires-Dist: pydantic<3,>=2.6
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.30; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# audigeo-mcp
+
+MCP server exposing the **AudiGEO.ai** GEO platform to MCP-compatible agents
+(Claude Code, Claude Desktop, and any other MCP host).
+
+Talks to the existing AudiGEO REST API at `https://audigeo.ai/api/v1` using
+an organization-level API key sent as `Authorization: Bearer <key>`. Requires
+plan **Pro** or **Agency**.
+
+---
+
+## What's exposed (v0.1.1)
+
+**26 tools** across 8 modules, **3 resources**, and **3 prompt templates**.
+All tool names are prefixed `audigeo_` so they don't collide with tools from
+other MCP servers a host might have mounted.
+
+| Module | Tool | Type |
+|---|---|---|
+| `sites` | `audigeo_list_sites` | read |
+| | `audigeo_get_site` | read |
+| | `audigeo_create_site` | write |
+| `audit` | `audigeo_list_audits` | read |
+| | `audigeo_get_audit` | read (composite) |
+| | `audigeo_list_recommendations` | read |
+| | `audigeo_launch_audit` | write |
+| `brand_profile` | `audigeo_get_brand_profile` | read |
+| | `audigeo_update_brand_profile` | write |
+| `monitoring` | `audigeo_get_monitoring_kpis` | read |
+| | `audigeo_get_monitoring_results` | read |
+| | `audigeo_get_competitors_analysis` | read |
+| | `audigeo_get_citations_gap` | read |
+| | `audigeo_run_monitoring_now` | write |
+| `hallucinations` | `audigeo_list_hallucinations` | read |
+| | `audigeo_get_hallucination_stats` | read |
+| `content` | `audigeo_list_content` | read |
+| | `audigeo_get_content` | read |
+| | `audigeo_generate_content` | write |
+| | `audigeo_generate_markdown_mirror` | write |
+| `alerts` | `audigeo_list_alerts` | read |
+| | `audigeo_mark_alert_read` | write |
+| `workflows` | `audigeo_audit_executive_summary` | composite |
+| | `audigeo_brand_safety_check` | composite |
+| | `audigeo_competitive_analysis` | composite |
+| | `audigeo_geo_action_plan` | composite |
+
+**Resources** (URI-addressable, read-only): `audigeo://audits/{audit_id}`,
+`audigeo://monitoring/results/{site_id}`, `audigeo://reports/{report_id}`.
+
+**Prompts**: `geo_audit_briefing`, `monitoring_weekly_recap`,
+`hallucination_response_draft` — all fr/en/es.
+
+Set `AUDIGEO_READ_ONLY=true` to disable every write tool at startup.
+
+---
+
+## Configuration
+
+| Env var | Required | Default | Purpose |
+|---|---|---|---|
+| `AUDIGEO_API_KEY` | yes | — | Your AudiGEO API key (`agk_...`). Generate at https://audigeo.ai → Settings → API Keys. |
+| `AUDIGEO_API_URL` | no | `https://audigeo.ai/api/v1` | Override for staging / self-hosted. |
+| `AUDIGEO_READ_ONLY` | no | `false` | Disable write tools. |
+| `AUDIGEO_DEFAULT_SITE_ID` | no | — | UUID used when an agent omits `site_id`. |
+| `AUDIGEO_TIMEOUT_S` | no | `60` | Per-request timeout. |
+| `AUDIGEO_LOG_LEVEL` | no | `INFO` | DEBUG / INFO / WARNING / ERROR / CRITICAL. |
+
+---
+
+## Use from Claude Desktop
+
+Install the AudiGEO `.mcpb` bundle (downloadable from Settings → Intégrations
+Claude on audigeo.ai). Claude Desktop will prompt for your API key on
+install — no manual config, no Python prerequisite (the bundle provisions its
+own environment on first launch).
+
+## Use from Claude Code
+
+Two ways to install, from most to least automated:
+
+**Via the Sponge Theory marketplace:**
+
+```
+/plugin marketplace add ezeeFlop/audigeo
+/plugin install audigeo@sponge-theory
+```
+
+**Manually**, from the downloaded `audigeo-claude-code-<version>.tar.gz`
+(Settings → Intégrations Claude on audigeo.ai):
+
+```bash
+mkdir -p ~/.claude/plugins
+tar -xzf audigeo-claude-code-*.tar.gz -C ~/.claude/plugins/
+```
+
+Either way, the plugin's `.mcp.json` launches the server via
+`uv tool run --from <plugin>/server audigeo-mcp` — **`uv` must be installed**
+(https://docs.astral.sh/uv/getting-started/installation/), but no `pip
+install` of `audigeo-mcp` is needed: `uv` builds and caches an isolated
+environment from the bundled source on first launch.
+
+Set your key once, then restart Claude Code:
+
+```bash
+export AUDIGEO_API_KEY=agk_...
+```
+
+## Use from any other MCP host
+
+The server speaks MCP over stdio. Point your host at:
+
+```bash
+AUDIGEO_API_KEY=agk_... audigeo-mcp
+```
+
+---
+
+## Development
+
+```bash
+cd mcp
+uv pip install -e ".[dev]"
+pytest -q
+ruff check .
+```
+
+Smoke test against a local AudiGEO dev server:
+
+```bash
+export AUDIGEO_API_KEY=agk_test_$(openssl rand -hex 8)
+export AUDIGEO_API_URL=http://localhost:8000/api/v1
+audigeo-mcp  # then send MCP frames over stdin
+```
+
+Build all three distributable artifacts (wheel, .mcpb, Claude Code plugin):
+
+```bash
+./build/build_wheel.sh
+./build/build_mcpb.sh
+./build/build_plugin.sh
+```
+
+---
+
+## License
+
+Sponge Theory proprietary. Distribution restricted to AudiGEO subscribers.

audigeo_mcp-0.1.2/README.md

@@ -0,0 +1,147 @@
+# audigeo-mcp
+
+MCP server exposing the **AudiGEO.ai** GEO platform to MCP-compatible agents
+(Claude Code, Claude Desktop, and any other MCP host).
+
+Talks to the existing AudiGEO REST API at `https://audigeo.ai/api/v1` using
+an organization-level API key sent as `Authorization: Bearer <key>`. Requires
+plan **Pro** or **Agency**.
+
+---
+
+## What's exposed (v0.1.1)
+
+**26 tools** across 8 modules, **3 resources**, and **3 prompt templates**.
+All tool names are prefixed `audigeo_` so they don't collide with tools from
+other MCP servers a host might have mounted.
+
+| Module | Tool | Type |
+|---|---|---|
+| `sites` | `audigeo_list_sites` | read |
+| | `audigeo_get_site` | read |
+| | `audigeo_create_site` | write |
+| `audit` | `audigeo_list_audits` | read |
+| | `audigeo_get_audit` | read (composite) |
+| | `audigeo_list_recommendations` | read |
+| | `audigeo_launch_audit` | write |
+| `brand_profile` | `audigeo_get_brand_profile` | read |
+| | `audigeo_update_brand_profile` | write |
+| `monitoring` | `audigeo_get_monitoring_kpis` | read |
+| | `audigeo_get_monitoring_results` | read |
+| | `audigeo_get_competitors_analysis` | read |
+| | `audigeo_get_citations_gap` | read |
+| | `audigeo_run_monitoring_now` | write |
+| `hallucinations` | `audigeo_list_hallucinations` | read |
+| | `audigeo_get_hallucination_stats` | read |
+| `content` | `audigeo_list_content` | read |
+| | `audigeo_get_content` | read |
+| | `audigeo_generate_content` | write |
+| | `audigeo_generate_markdown_mirror` | write |
+| `alerts` | `audigeo_list_alerts` | read |
+| | `audigeo_mark_alert_read` | write |
+| `workflows` | `audigeo_audit_executive_summary` | composite |
+| | `audigeo_brand_safety_check` | composite |
+| | `audigeo_competitive_analysis` | composite |
+| | `audigeo_geo_action_plan` | composite |
+
+**Resources** (URI-addressable, read-only): `audigeo://audits/{audit_id}`,
+`audigeo://monitoring/results/{site_id}`, `audigeo://reports/{report_id}`.
+
+**Prompts**: `geo_audit_briefing`, `monitoring_weekly_recap`,
+`hallucination_response_draft` — all fr/en/es.
+
+Set `AUDIGEO_READ_ONLY=true` to disable every write tool at startup.
+
+---
+
+## Configuration
+
+| Env var | Required | Default | Purpose |
+|---|---|---|---|
+| `AUDIGEO_API_KEY` | yes | — | Your AudiGEO API key (`agk_...`). Generate at https://audigeo.ai → Settings → API Keys. |
+| `AUDIGEO_API_URL` | no | `https://audigeo.ai/api/v1` | Override for staging / self-hosted. |
+| `AUDIGEO_READ_ONLY` | no | `false` | Disable write tools. |
+| `AUDIGEO_DEFAULT_SITE_ID` | no | — | UUID used when an agent omits `site_id`. |
+| `AUDIGEO_TIMEOUT_S` | no | `60` | Per-request timeout. |
+| `AUDIGEO_LOG_LEVEL` | no | `INFO` | DEBUG / INFO / WARNING / ERROR / CRITICAL. |
+
+---
+
+## Use from Claude Desktop
+
+Install the AudiGEO `.mcpb` bundle (downloadable from Settings → Intégrations
+Claude on audigeo.ai). Claude Desktop will prompt for your API key on
+install — no manual config, no Python prerequisite (the bundle provisions its
+own environment on first launch).
+
+## Use from Claude Code
+
+Two ways to install, from most to least automated:
+
+**Via the Sponge Theory marketplace:**
+
+```
+/plugin marketplace add ezeeFlop/audigeo
+/plugin install audigeo@sponge-theory
+```
+
+**Manually**, from the downloaded `audigeo-claude-code-<version>.tar.gz`
+(Settings → Intégrations Claude on audigeo.ai):
+
+```bash
+mkdir -p ~/.claude/plugins
+tar -xzf audigeo-claude-code-*.tar.gz -C ~/.claude/plugins/
+```
+
+Either way, the plugin's `.mcp.json` launches the server via
+`uv tool run --from <plugin>/server audigeo-mcp` — **`uv` must be installed**
+(https://docs.astral.sh/uv/getting-started/installation/), but no `pip
+install` of `audigeo-mcp` is needed: `uv` builds and caches an isolated
+environment from the bundled source on first launch.
+
+Set your key once, then restart Claude Code:
+
+```bash
+export AUDIGEO_API_KEY=agk_...
+```
+
+## Use from any other MCP host
+
+The server speaks MCP over stdio. Point your host at:
+
+```bash
+AUDIGEO_API_KEY=agk_... audigeo-mcp
+```
+
+---
+
+## Development
+
+```bash
+cd mcp
+uv pip install -e ".[dev]"
+pytest -q
+ruff check .
+```
+
+Smoke test against a local AudiGEO dev server:
+
+```bash
+export AUDIGEO_API_KEY=agk_test_$(openssl rand -hex 8)
+export AUDIGEO_API_URL=http://localhost:8000/api/v1
+audigeo-mcp  # then send MCP frames over stdin
+```
+
+Build all three distributable artifacts (wheel, .mcpb, Claude Code plugin):
+
+```bash
+./build/build_wheel.sh
+./build/build_mcpb.sh
+./build/build_plugin.sh
+```
+
+---
+
+## License
+
+Sponge Theory proprietary. Distribution restricted to AudiGEO subscribers.

audigeo_mcp-0.1.2/build/build_mcpb.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+# Build the Claude Desktop MCPB bundle from mcp/mcpb/.
+# Output: mcp/dist/audigeo-<VERSION>.mcpb (zip file with renamed extension)
+#
+# Usage: ./build_mcpb.sh
+
+set -euo pipefail
+
+MCP_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$MCP_DIR"
+
+VERSION=$(grep -E "^version" pyproject.toml | head -1 | sed -E 's/.*"([^"]+)".*/\1/')
+if [ -z "$VERSION" ]; then
+    echo "ERROR: cannot parse version from pyproject.toml" >&2
+    exit 1
+fi
+
+mkdir -p dist
+OUT="${MCP_DIR}/dist/audigeo-${VERSION}.mcpb"
+
+if [ ! -d "mcpb" ]; then
+    echo "ERROR: mcpb/ template missing" >&2
+    exit 1
+fi
+
+STAGE=$(mktemp -d)
+trap 'rm -rf "$STAGE"' EXIT
+
+cp -R mcpb/* "$STAGE/"
+
+# Embed the server source so the bundle is self-contained
+mkdir -p "$STAGE/server"
+cp -R src "$STAGE/server/src"
+cp pyproject.toml "$STAGE/server/pyproject.toml"
+cp README.md "$STAGE/server/README.md"
+
+# Bundle the wheel so bootstrap.py can provision dependencies on the user's
+# machine at first run (pip resolves the correct per-platform binaries —
+# vendoring compiled deps like pydantic-core into one cross-platform bundle is
+# not possible). Build the wheel first if it isn't in dist/ yet.
+mkdir -p "$STAGE/server/wheels"
+WHEEL=$(ls -t dist/audigeo_mcp-*.whl 2>/dev/null | head -1 || true)
+if [ -z "${WHEEL:-}" ]; then
+    echo "No wheel in dist/ — building it first…"
+    "$(dirname "$0")/build_wheel.sh" >/dev/null
+    WHEEL=$(ls -t dist/audigeo_mcp-*.whl 2>/dev/null | head -1 || true)
+fi
+if [ -z "${WHEEL:-}" ]; then
+    echo "ERROR: could not build/find the audigeo_mcp wheel" >&2
+    exit 1
+fi
+cp "$WHEEL" "$STAGE/server/wheels/"
+echo "Bundled wheel: $(basename "$WHEEL")"
+
+# Inject version into manifest.json
+MANIFEST="$STAGE/manifest.json"
+if [ -f "$MANIFEST" ]; then
+    /usr/bin/sed -i.bak -E "s/\"version\": *\"[^\"]+\"/\"version\": \"${VERSION}\"/" "$MANIFEST"
+    rm -f "${MANIFEST}.bak"
+fi
+
+# Strip macOS metadata
+find "$STAGE" -name '.DS_Store' -delete 2>/dev/null || true
+find "$STAGE" -name '__pycache__' -type d -exec rm -rf {} + 2>/dev/null || true
+
+# .mcpb is just a zip
+rm -f "$OUT"
+(cd "$STAGE" && zip -qr "$OUT" .)
+
+echo "Built: $OUT ($(du -h "$OUT" | awk '{print $1}'))"

audigeo_mcp-0.1.2/build/build_plugin.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+# Build the Claude Code plugin tar.gz from mcp/claude_code_plugin/.
+# Output: mcp/dist/audigeo-claude-code-<VERSION>.tar.gz
+#
+# Usage: ./build_plugin.sh
+
+set -euo pipefail
+
+MCP_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$MCP_DIR"
+
+# Read version from pyproject.toml
+VERSION=$(grep -E "^version" pyproject.toml | head -1 | sed -E 's/.*"([^"]+)".*/\1/')
+if [ -z "$VERSION" ]; then
+    echo "ERROR: cannot parse version from pyproject.toml" >&2
+    exit 1
+fi
+
+mkdir -p dist
+OUT="dist/audigeo-claude-code-${VERSION}.tar.gz"
+
+if [ ! -d "claude_code_plugin" ]; then
+    echo "ERROR: claude_code_plugin/ template missing" >&2
+    exit 1
+fi
+
+# Stage to a temp dir so the tarball has a clean top-level directory
+STAGE=$(mktemp -d)
+trap 'rm -rf "$STAGE"' EXIT
+cp -R claude_code_plugin "${STAGE}/audigeo"
+
+# Inject version into .claude-plugin/plugin.json
+PLUGIN_JSON="${STAGE}/audigeo/.claude-plugin/plugin.json"
+if [ -f "$PLUGIN_JSON" ]; then
+    /usr/bin/sed -i.bak -E "s/\"version\": *\"[^\"]+\"/\"version\": \"${VERSION}\"/" "$PLUGIN_JSON"
+    rm -f "${PLUGIN_JSON}.bak"
+fi
+
+# Bundle the MCP server SOURCE (not a wheel) under server/, so .mcp.json's
+# `uv tool run --from ${CLAUDE_PLUGIN_ROOT}/server audigeo-mcp` can build and
+# run it with no PyPI publish and no pre-existing venv on the user's machine —
+# uv resolves the interpreter, builds an isolated env, and caches it per
+# server/ content hash. Mirrors what build_mcpb.sh does for the .mcpb bundle.
+SERVER_DIR="${STAGE}/audigeo/server"
+mkdir -p "$SERVER_DIR"
+cp -R src "$SERVER_DIR/src"
+cp pyproject.toml "$SERVER_DIR/pyproject.toml"
+cp README.md "$SERVER_DIR/README.md"
+
+# Strip macOS metadata and caches
+find "$STAGE" -name '.DS_Store' -delete 2>/dev/null || true
+find "$STAGE" -name '__pycache__' -type d -exec rm -rf {} + 2>/dev/null || true
+
+tar -czf "$OUT" -C "$STAGE" audigeo
+echo "Built: $OUT ($(du -h "$OUT" | awk '{print $1}'))"

audigeo_mcp-0.1.2/build/build_wheel.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+# Build the audigeo-mcp Python wheel.
+# Output: mcp/dist/audigeo_mcp-<VERSION>-py3-none-any.whl + .tar.gz
+#
+# Usage: ./build_wheel.sh
+
+set -euo pipefail
+
+MCP_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$MCP_DIR"
+
+# Don't rm dist/ — other build scripts have already populated it
+rm -f dist/audigeo_mcp-*.whl dist/audigeo_mcp-*.tar.gz 2>/dev/null || true
+
+# Prefer uv (already used in the project), fall back to python -m build
+if command -v uv >/dev/null 2>&1; then
+    uv build --wheel --sdist --out-dir dist 2>&1 | tail -5
+else
+    "${PYTHON:-python}" -m build --wheel --sdist --outdir dist . 2>&1 | tail -5
+fi
+
+echo ""
+echo "Built artifacts:"
+ls -lh dist/audigeo_mcp-*.whl dist/audigeo_mcp-*.tar.gz 2>/dev/null

audigeo_mcp-0.1.2/claude_code_plugin/.claude-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "audigeo",
+  "version": "0.1.2",
+  "description": "AudiGEO.ai — audit GEO, monitoring IA, hallucinations, génération de contenu, depuis Claude Code.",
+  "author": {
+    "name": "Sponge Theory",
+    "email": "support@audigeo.ai",
+    "url": "https://audigeo.ai"
+  },
+  "homepage": "https://audigeo.ai",
+  "license": "Sponge Theory Proprietary",
+  "keywords": ["geo", "seo", "ai-monitoring", "audigeo", "sponge-theory"]
+}

audigeo_mcp-0.1.2/claude_code_plugin/.mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "audigeo": {
+      "command": "uv",
+      "args": ["tool", "run", "--from", "${CLAUDE_PLUGIN_ROOT}/server", "audigeo-mcp"],
+      "env": {
+        "AUDIGEO_API_KEY": "${AUDIGEO_API_KEY}"
+      }
+    }
+  }
+}

audigeo_mcp-0.1.2/claude_code_plugin/README.md

@@ -0,0 +1,64 @@
+# AudiGEO Claude Code plugin
+
+GEO audits, AI-platform monitoring, hallucination detection, and content
+generation, accessible directly inside Claude Code.
+
+## Install
+
+**Via the Sponge Theory marketplace (recommended):**
+
+```
+/plugin marketplace add ezeeFlop/audigeo
+/plugin install audigeo@sponge-theory
+```
+
+**Manually**, from the downloaded `audigeo-claude-code-<version>.tar.gz`
+(https://audigeo.ai → Settings → Intégrations Claude):
+
+```bash
+mkdir -p ~/.claude/plugins
+tar -xzf audigeo-claude-code-*.tar.gz -C ~/.claude/plugins/
+```
+
+Either way, the bundled `.mcp.json` launches the MCP server via
+`uv tool run --from <plugin>/server audigeo-mcp` — **you need `uv` installed**
+(https://docs.astral.sh/uv/getting-started/installation/). No `pip install`
+needed: `uv` builds and caches an isolated environment from the bundled
+server source on first launch.
+
+## Configure
+
+Set your API key (generate at https://audigeo.ai → Settings → API Keys,
+requires plan Pro or Agency) in your shell environment before starting Claude
+Code:
+
+```bash
+export AUDIGEO_API_KEY=agk_...
+```
+
+Restart Claude Code. Try `/audigeo-status` to verify.
+
+## What's included
+
+- **MCP server**: 26 tools, 3 resources, 3 prompt templates (see
+  https://audigeo.ai/docs/mcp for the complete list).
+- **7 skills**: contextual guidance the agent loads on demand (audit,
+  monitoring, hallucination triage, brand profile, content generation, bot
+  analytics, product overview).
+- **4 slash commands**: `/audigeo-status`, `/audigeo-audit`,
+  `/audigeo-monitor`, `/audigeo-content`.
+- **Subagent `audigeo-strategist`**: an in-house GEO expert agent with the
+  full toolkit at its disposal.
+
+## Configuration
+
+| Env var | Default | Purpose |
+|---|---|---|
+| `AUDIGEO_API_KEY` | — (required) | Your AudiGEO API key (`agk_...`). |
+| `AUDIGEO_API_URL` | `https://audigeo.ai/api/v1` | Override for staging/self-hosted — export it in your shell if you need a non-default value. |
+| `AUDIGEO_READ_ONLY` | `false` | When `true`, disables every write tool. |
+| `AUDIGEO_DEFAULT_SITE_ID` | — | UUID used when an agent omits `site_id`. |
+
+## License
+
+Sponge Theory proprietary. Distribution restricted to AudiGEO subscribers.

audigeo_mcp-0.1.2/claude_code_plugin/agents/audigeo-strategist.md

@@ -0,0 +1,50 @@
+---
+name: audigeo-strategist
+description: Use proactively for any question that needs a holistic GEO strategy across audit + monitoring + content + hallucinations — when the user asks "what should I do overall about my AI visibility", "give me a quarterly plan", "audit my whole AudiGEO setup", or wants a senior GEO consultant's POV. This subagent runs deeper analyses than a single tool call would.
+tools: ["mcp__audigeo__*"]
+---
+
+Tu es un consultant senior en Generative Engine Optimization, déployé en tant que sub-agent dans Claude Code. Tu as accès à tous les outils MCP `audigeo_*` du serveur AudiGEO de l'utilisateur (audits, monitoring, hallucinations, contenu, brand profile, alerts, workflows composites).
+
+## Mission
+
+Quand on t'invoque, l'utilisateur cherche une vue d'ensemble stratégique, pas une réponse ponctuelle à un outil. Ton job est de :
+
+1. **Diagnostiquer** : collecter l'état actuel sur les 4 axes (audit, monitoring, hallucinations, contenu) via plusieurs outils.
+2. **Synthétiser** : repérer les patterns transverses (ex: "audit faible sur Schema.org + monitoring faible sur Gemini = besoin de structurer la donnée").
+3. **Prioriser** : donner un plan d'action sur 3 horizons (cette semaine, ce mois, ce trimestre).
+
+## Méthode
+
+À chaque invocation, exécute ce flow :
+
+1. `audigeo_list_sites` — quels sites sont configurés
+2. Pour le site principal : `audigeo_list_audits(site_id, limit=1)` puis `audigeo_get_audit(latest_audit_id)`
+3. `audigeo_get_monitoring_kpis(site_id, days=30)`
+4. `audigeo_competitive_analysis(site_id, days=30)`
+5. `audigeo_get_citations_gap(site_id)`
+6. `audigeo_brand_safety_check(days=14)`
+7. `audigeo_get_brand_profile`
+8. `audigeo_list_alerts(unread_only=True)` — pour voir s'il y a des alertes ouvertes critiques
+
+## Format de sortie
+
+Markdown structuré en français :
+
+- **Synthèse** (2-3 paragraphes) : le diagnostic global, en langage business.
+- **Forces actuelles** : ce qui marche déjà, à conserver.
+- **Faiblesses prioritaires** : 3-5 zones à corriger, ordonnées par leverage.
+- **Plan d'action 90 jours** :
+  - **Semaine 1-2** : 2-3 actions tactiques (quick wins P0 de l'audit + correction des hallucinations critiques).
+  - **Mois 1-3** : 4-5 actions structurelles (renforcer Schema.org, déployer Markdown Mirrors, presse/Wikipédia, prompts monitoring élargis).
+  - **Trimestre suivant** : 2-3 paris (nouveau contenu majeur, repositionnement Brand Profile, etc.).
+- **KPIs à suivre** : les 3 chiffres à surveiller au prochain check-in (avec valeurs cibles).
+
+## Anti-patterns
+
+- **Ne pas** te contenter de relayer le résultat d'un seul outil — ton job est l'analyse transverse.
+- **Ne pas** inventer de chiffres : si une donnée manque, dis "non disponible" et précise quel outil ne l'a pas retournée.
+- **Ne pas** mélanger les niveaux : un audit faible n'est pas la même question qu'un Share of Voice faible. Traite-les séparément.
+- **Ne pas** déclencher d'écriture (audit, génération de contenu, modification du profil) sans confirmation explicite de l'utilisateur principal qui t'a invoqué.
+
+Ton ton : expert posé, en français, factuel. Pas de jargon marketing creux. Tu parles à un dirigeant ou un responsable marketing qui doit décider d'investir du temps ou du budget.

audigeo_mcp-0.1.2/claude_code_plugin/commands/audigeo-audit.md

@@ -0,0 +1,19 @@
+---
+description: Lance un audit GEO sur un site et présente le résultat dès qu'il est prêt.
+argument-hint: "<site_id ou URL>"
+---
+
+Tu vas lancer un audit GEO et restituer le résultat. L'utilisateur t'a passé un identifiant de site ou une URL en argument : $ARGUMENTS.
+
+1. Si l'argument ressemble à une URL (commence par `http`), commence par `audigeo_list_sites` et trouve le site correspondant. Si aucun ne match, propose à l'utilisateur de créer le site d'abord (`audigeo_create_site` — demande confirmation avant).
+2. Sinon, traite l'argument comme un `site_id` UUID.
+3. Lance l'audit : `audigeo_launch_audit(site_id)`. Récupère l'`audit_id` retourné.
+4. Indique à l'utilisateur que l'audit est en cours (durée typique 5-15 min).
+5. **Poll** `audigeo_get_audit(audit_id)` toutes les 60s jusqu'à ce que `status` soit `COMPLETED` ou `FAILED` (max 20 tentatives = 20 min).
+6. Une fois `COMPLETED` :
+   - Présente les 4 scores (global, technique, contenu, autorité) en français.
+   - Appelle `audigeo_geo_action_plan(audit_id, max_actions=3)` pour le top 3 des priorités.
+   - Présente chaque priorité avec son `title`, `priority`, `impact`, `effort`.
+   - Termine par UNE recommandation concrète à attaquer cette semaine.
+
+Si le quota plan est atteint (HTTP 402), indique-le et propose l'upgrade Pro/Agency.

audigeo_mcp-0.1.2/claude_code_plugin/commands/audigeo-content.md

@@ -0,0 +1,26 @@
+---
+description: Génère un contenu GEO optimisé (article / FAQ / llms.txt / Schema.org / etc.) pour un site.
+argument-hint: "<type> <brief>"
+---
+
+Tu vas générer un contenu GEO. L'utilisateur a passé : $ARGUMENTS.
+
+Le format attendu est `<type> <brief en texte libre>` où `<type>` est l'un de :
+- `article` — article long, markdown
+- `faq` — FAQ avec balisage FAQPage Schema
+- `llms_txt` — fichier llms.txt racine
+- `llms_full_txt` — version exhaustive
+- `robots_txt` — robots.txt avec User-agents IA
+- `schema_org` — JSON-LD Organization / LocalBusiness / Product
+
+Procédure :
+
+1. Parse `$ARGUMENTS` : premier token = `<type>`, reste = `<brief>`.
+2. Valide que le type est dans la liste autorisée. Sinon, demande à l'utilisateur de préciser.
+3. Récupère le `site_id` : si l'utilisateur n'a pas précisé via `AUDIGEO_DEFAULT_SITE_ID`, appelle `audigeo_list_sites` et utilise le premier (ou demande).
+4. Appelle `audigeo_generate_content(content_type=<type>, brief=<brief>, site_id=<site_id>)`.
+5. La génération est async — tu reçois un `content_id` avec `generation_status="generating"`.
+6. Poll `audigeo_get_content(content_id)` toutes les 15s jusqu'à `generation_status="generated"` (max 8 tentatives = 2 min).
+7. Présente le contenu généré à l'utilisateur, formaté pour qu'il puisse le copier directement.
+
+Si quota atteint (HTTP 402) : propose l'upgrade Agency. Si génération échoue (HTTP 500 / status `failed`) : montrer le `generation_error` et proposer de relancer.