CongoFinder AI Docs
API reference

Introduction à CongoFinder AI

Bienvenue sur le portail développeur de CongoFinder 2, l'écosystème d'accès intelligent aux données économiques, offres d'emploi, et publications en République du Congo.

Notre plateforme expose des API structurées et des serveurs d'intégration intelligents pour connecter vos solutions aux entreprises locales de Brazzaville, Pointe-Noire, et de toutes les localités congolaises. Qu'il s'agisse de recherche textuelle, d'analyse transactionnelle, ou d'agents de messagerie autonomes, CongoFinder met la puissance de la recherche sémantique à votre service.

Une architecture en trois couches

Pour répondre aux différents besoins de développement d'applications modernes, nous structurons notre hub d'intégration autour de trois couches distinctes :

1. L'API REST standard

Accès HTTP simple délivrant des enregistrements JSON structurés hautement typés. Idéal pour synchroniser des fiches d'entreprises, intégrer des bases d'annuaires dans vos bases SQL relationnelles, ou requêter des listes de jobs.

2. L'API Chatbot IA (Messages)

Interface conversationnelle avancée qui analyse l'intention en langage naturel et extrait dynamiquement les entités. Elle maintient les fils de discussion en base de données et résout automatiquement les manques géographiques ou sémantiques.

3. Le protocole MCP (Model Context Protocol)

Le dernier standard d'Anthropic pour interfacer en temps réel notre base de données avec vos propres LLMs. Intégrable directement dans Cursor, Claude Desktop ou Windsurf sous forme d'outils ("Tools") prêts à l'emploi.

CongoFinder Model Suite

Nos endpoints sont motorisés par une famille de modèles virtuels spécialisés selon les contraintes de performance et d'exécution :

Sonnet-CF (v2.0) Moteur Conversationnel

Moteur d'intention sémantique. Interprète le langage naturel, gère l'historique conversationnel avec mémoire de session et résout les entreprises locales.

Haiku-CF (v2.0) Stateless MCP Gateway

Passerelle ultra-rapide (<180ms) pour le protocole MCP. Lie en temps réel la base de données CongoFinder aux outils d'agents autonomes.

Opus-CF (v2.0) High-Throughput REST Core

Moteur de distribution standard. Conçu pour le traitement analytique de gros volumes de données, l'exploration de graphes et les exports d'offres d'emploi.

Caractéristiques de la Suite :
Latence moyenne (REST) : < 150 ms
Latence moyenne (IA) : < 1.2 s
Disponibilité des Endpoints : 99.98 %

Start building with CongoFinder

Everything you need to integrate CongoFinder 2 into your applications. From your first API call to production.

Prerequisites: A valid CongoFinder developer API key. You can generate or copy your key dynamically in the section below.

Choose how you build

Select the developer interface that matches your approach, whether you require structured records or real-time LLM tool context.

REST API & SDKs

Direct structured JSON access. Ideal for traditional websites, search indexes and background synchronization jobs.

CongoFinder IA & MCP

Connect real-time data directly to LLMs (Claude, Cursor, ChatGPT) using the Anthropic Model Context Protocol.

Call the API (Quickstart)

1

Get your API key

Use your dynamic key below or regenerate a new token if needed.

Sign in to retrieve your API key Sign In
2

Execute your first search

Pass your bearer token in the HTTP Authorization header to authenticate requests.

Quickstart Snippet
curl -G "http://localhost:8000/api/companies/search" \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  --data-urlencode "q=WEEGOSOFT" \
  --data-urlencode "town=Brazzaville"
fetch("http://localhost:8000/api/companies/search?q=WEEGOSOFT&town=Brazzaville", {
  headers: {
    "Authorization": "Bearer VOTRE_CLE_API"
  }
})
.then(res => res.json())
.then(data => console.log(data));
<?php
$client = new \GuzzleHttp\Client();
$response = $client->get('http://localhost:8000/api/companies/search', [
    'headers' => [
        'Authorization' => 'Bearer VOTRE_CLE_API',
    ],
    'query' => [
        'q' => 'WEEGOSOFT',
        'town' => 'Brazzaville'
    ]
]);

$data = json_decode($response->getBody(), true);
print_r($data);
import requests

url = "http://localhost:8000/api/companies/search"
headers = {
    "Authorization": "Bearer VOTRE_CLE_API"
}
params = {
    "q": "WEEGOSOFT",
    "town": "Brazzaville"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

REST API Reference

Explore and test our standard OpenAPI 3.0 endpoints directly from the browser.

Authentication: All REST endpoints require your developer API key passed as a Bearer Token in the Authorization header.
API Response JSON
{
  "status": "success",
  "results": [
    {
      "id": 1225,
      "name": "WEEGOSOFT-WTNB",
      "description": "Société de services informatiques et formation...",
      "phone": "+242069449224",
      "email": "contact@weegosoft.com",
      "address": "En ligne, 1, COG",
      "town": "Brazzaville",
      "is_verified": true
    }
  ]
}

Using the Chatbot API

CongoFinder conversation endpoint understands natural language intent and outputs structured replies.

Basic request and response

Send a standard JSON payload with the user's message to /api/ai/chat to retrieve conversation text and matched records.

Multiple conversational turns

Provide the conversation_id in the context array to persist user states and thread chat histories automatically in the database.

System Rules: The AI Assistant will automatically require geolocation confirmation when user queries are geo-dependent but omit location tags.
Chat API Request
{
  "message": "Je cherche un bon restaurant à Brazzaville",
  "context": {
    "conversation_id": "session-12345"
  }
}
{
  "message": "Voici les meilleurs restaurants à Brazzaville :",
  "conversation_id": "session-12345",
  "companies": [
    {
      "id": 2040,
      "name": "Yummy",
      "town": "Brazzaville",
      "rating": 4.8
    }
  ],
  "quick_replies": [
    {"label": "Voir d'autres restaurants", "query": "restaurants à proximité"}
  ]
}

Model Context Protocol (MCP)

Connect CongoFinder's live business search directly to AI models like Claude Desktop, VSCode or Cursor.

Capabilities & Tools

Our server exposes high-performance agentic tools :

search_companies get_company_details check_availability search_reviews post_lead post_job post_article get_company_stats

Setup instructions

1

Configure your IDE (Cursor)

Go to Settings > Models > MCP, click + Add New MCP Server, and configure as SSE type with your dynamic config generated on the right.

2

Configure Claude Desktop

Add our configuration to your local claude_desktop_config.json file to let Claude explore Congolese merchants.

MCP Configuration File
{
  "mcpServers": {
    "congofinder-mcp": {
      "type": "sse",
      "url": "http://localhost:8000/mcp-server.php",
      "headers": {
        "Authorization": "Bearer VOTRE_CLE_API"
      }
    }
  }
}
{
  "mcpServers": {
    "congofinder-mcp": {
      "command": "php",
      "args": [
        "c:/laragon/www/entreprises.congofinder/public/mcp-server.php"
      ],
      "env": {
        "MCP_SECRET_KEY": "VOTRE_CLE_API"
      }
    }
  }
}

Live Workspace Sandbox

Interact directly with the chatbot, send queries, check availability, and inspect the real-time JSON responses returned by WSM API.

Chatbot Console Workspace Live
Bonjour ! 👋 Je suis l'assistant conversationnel CongoFinder.
REAL-TIME JSON RESPONSE VIEW
{}