Docs/Canopée
BETA · v0.1.0 · @silverbackbase/canopee

Canopée

Content Territory Map. Cartographiez l'espace sémantique de votre marché — qui possède quoi, où attaquer en premier.

copiez dans votre agent IA

Quickstart

1. Connecter le MCP à votre agent

Canopée expose un serveur MCP HTTP standard. Ajoutez l'URL dans votre client IA.

Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "canopee": {
      "type": "http",
      "url": "https://canopee.silverbackbase.com/mcp",
      "headers": {
        "Authorization": "Bearer sb_live_votre_clé"
      }
    }
  }
}
Claude CodeTerminal
claude mcp add canopee --transport http https://canopee.silverbackbase.com/mcp --header "Authorization: Bearer sb_live_votre_clé"
Antigravity CLI~/.gemini/antigravity/mcp_config.json
{
  "mcpServers": {
    "canopee": {
      "type": "http",
      "url": "https://canopee.silverbackbase.com/mcp",
      "headers": {
        "Authorization": "Bearer sb_live_votre_clé"
      }
    }
  }
}
Codex CLI~/.codex/config.toml
[mcp_servers.canopee]
url = "https://canopee.silverbackbase.com/mcp"
http_headers = { "Authorization" = "Bearer sb_live_votre_clé" }
Windsurf~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "canopee": {
      "serverUrl": "https://canopee.silverbackbase.com/mcp",
      "headers": {
        "Authorization": "Bearer sb_live_votre_clé"
      }
    }
  }
}
Gemini CLI~/.gemini/settings.json
{
  "mcpServers": {
    "canopee": {
      "httpUrl": "https://canopee.silverbackbase.com/mcp",
      "headers": {
        "Authorization": "Bearer sb_live_votre_clé"
      }
    }
  }
}

2. Créer votre première carte

Demandez à votre agent de construire la carte sémantique de votre domaine :

"Crée une carte du territoire sémantique pour monsite.fr vs concurrent1.fr et concurrent2.fr"
{
  "map_id": "a3f9c2d1-...",
  "domain": "monsite.fr",
  "competitors": ["concurrent1.fr", "concurrent2.fr"],
  "territories_count": 18,
  "keywords_count": 1247
}

Conservez le map_id retourné — il sert à toutes les requêtes suivantes.

3. Interroger les gaps

Une fois la carte créée, l'agent peut identifier les territoires à fort potentiel :

"Quels sont les 5 meilleurs territoires à attaquer ?"
[
  {
    "name": "logiciel comptabilité pme",
    "gap_score": 94,
    "my_share_pct": 3,
    "best_keyword": {
      "keyword": "logiciel comptabilité tpe",
      "volume": 2400,
      "difficulty": 28,
      "opportunity_score": 86
    }
  }
]
Beta — l'API peut évoluer. Les retours sont bienvenus sur GitHub.

MCP Tools

ToolDescription
canopee_create_mapConstruit et persiste la carte — domaine + concurrents. Retourne un map_id.
canopee_get_territoriesListe tous les territoires avec leur score de possession par domaine.
canopee_get_gapsRetourne les meilleures opportunités triées par gap score et ratio volume/difficulté.
canopee_get_keywordsMots-clés d'un territoire triés par opportunity score. Pour forer après get_gaps.
canopee_refreshRelance l'analyse avec des données fraîches. Retourne le drift depuis la dernière carte.

Exemples de prompts

"Quels territoires sémantiques mes concurrents dominent-ils que j'ignore complètement ?"
"Où est-ce que je produis du contenu dans des zones déjà verrouillées par des acteurs plus forts ?"
"Quel territoire non réclamé a le meilleur rapport volume de recherche / difficulté de ranking ?"
"Quelles thématiques génèrent du trafic chez mes concurrents mais sont absentes de mon site ?"
"Où dois-je publier en premier pour capturer du territoire avant qu'un concurrent s'y installe ?"
"Mon budget contenu de ce trimestre est-il orienté vers des zones gagnables ou perdues d'avance ?"

Self-host

npm install @silverbackbase/canopee
Voir sur GitHub →