Les AVPs pour les développeurs

🚀 Une API publique, trois façons de l’utiliser

Les données de cette plateforme sont intégrables dans vos applications, scripts, tableaux de bord ou agents IA. Tout passe par le portail d’APIs de l’OPT-NC :

  1. Créez un compte sur le portail et une app ;
  2. Abonnez-la au produit avps (approbation automatique) ;
  3. Récupérez votre clé API (« Key » dans les détails de votre app).

🔎 L’API REST de recherche

Exemples avec httpie (brew install httpie / apt install httpie) :

Recherche sémantique — décrivez le poste en langage naturel :

http POST https://api.opt.nc/avps/search \
  x-apikey:$API_KEY \
  prompt="développeur informatique orienté données"

Filtres structurés — commune, province et direction utilisent les référentiels officiels (voir les valeurs admises dans la spécification OpenAPI) :

http POST https://api.opt.nc/avps/search \
  x-apikey:$API_KEY \
  filters:='{"ville": "Nouméa", "province": "province Sud"}'
http POST https://api.opt.nc/avps/search \
  x-apikey:$API_KEY \
  filters:='{"direction": "DIRECTION DES SYSTEMES D'\''INFORMATION"}' \
  options:='{"top_k": 10}'

Combinez les deux — le prompt affine, les filtres bornent :

http POST https://api.opt.nc/avps/search \
  x-apikey:$API_KEY \
  prompt="management d'équipe" \
  filters:='{"province": "province Nord"}'

Chaque résultat contient la fiche complète au format Schema.org/JobPosting (json_data), plus les champs de synthèse (titre, ville, province, familles, direction, distance).

🤖 Le serveur MCP pour les agents IA

Vos assistants (Claude, Gemini, agents maison…) peuvent interroger les AVPs nativement via le protocole MCP (Model Context Protocol) :

  • Endpoint : https://api.opt.nc/mcp (transport HTTP streamable)
  • Authentification : header x-apikey (produit mcp-emploi sur le portail), ou OAuth 2.0 client_credentials via POST /oauth/token

Exemple de configuration pour Claude Code :

claude mcp add --transport http avp-opt https://api.opt.nc/mcp \
  --header "x-apikey: $API_KEY"

L’agent découvre alors les outils de recherche (searchAvp, référentiel métiers, open data) et peut répondre à des questions comme « quels postes sont ouverts en province Nord ? » en croisant plusieurs sources.

📊 La donnée brute (open data)

  • Dataset Hugging Face : opt-nc/odata-avps — le corpus consolidé (JSONL) et les embeddings (Parquet) des AVP actifs ;
  • Flux d’intégration emploi : sitemap dédié et JSON-LD JobPosting embarqué dans chaque page.

📬 Support

Une idée d’intégration, un besoin de quota supérieur, un bug ? Ouvrez une issue sur le dépôt du projet ou contactez le support via le portail d’APIs.