Les AVP pour les développeurs

🔓 Tout est réutilisable, sans clé ni compte

Il n’y a pas d’API sur ce site, et c’est délibéré : les données sont exposées sous forme de fichiers statiques, que n’importe quel client HTTP peut lire directement. Rien à demander, rien à s’abonner, aucune limite de débit.

📄 Le JSON-LD, le plus simple pour une offre

Chaque page d’offre embarque son balisage Schema.org/JobPosting dans un <script type="application/ld+json">. C’est la même structure que celle lue par Google Jobs, donc directement exploitable :

curl -s https://avps.nc/administration-generale/26-1301/ \
  | sed -n '/application\/ld+json/,/<\/script>/p' \
  | sed '1d;$d' | jq '.title, .hiringOrganization.name, .validThrough'

🧭 Ce que contient une fiche

Au-delà des champs Schema.org standard, chaque offre porte :

• collectivite — la collectivité qui recrute (elle seule est l’employeur) ;
• direction — la direction de rattachement en son sein ;
• famille — l’une des 41 familles du référentiel RESPNC, et famille_source qui dit comment elle a été déterminée (respnc = appariement sur le référentiel, gemini = classification par le modèle, defaut = non rattachée) ;
• code_rome — la classification ROME quand elle est connue ;
• latitude / longitude — le géocodage du lieu de travail.

⚠️ Deux mises en garde

Le PDF officiel fait seul foi. Ces fiches sont produites automatiquement : en cas de divergence, référez-vous au document d’origine, dont l’URL est dans chaque offre.

Ne réutilisez pas ce site comme employeur. Chaque offre a la sienne (hiringOrganization) : un agrégateur qui afficherait « avps.nc » comme entreprise recruteuse enverrait les candidats au mauvais endroit.

🤖 Et un serveur MCP ?

Pas encore. Un endpoint MCP et une recherche sémantique (« trouve-moi les postes proches de celui-ci ») sont prévus le jour où un service dynamique sera déployé ; les vecteurs sont déjà calculés pour chaque offre en attendant.