English Français العربية

io.github.iQuesta/MCP-iQuesta

السجل الرسمي أخرى

Recherche d'offres de stage et d'alternance en France via le réseau iQuesta.com

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http mcp-iquesta 'https://mcp.iquesta.com/api/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "mcp-iquesta": {
            "type": "http",
            "url": "https://mcp.iquesta.com/api/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. iQuesta MCP Server
  2. Endpoint
  3. Tools disponibles
  4. Exemples d'utilisation
  5. Configuration côté client
  6. À propos d'iQuesta
  7. Licence

iQuesta MCP Server

Connecteur Model Context Protocol pour iQuesta.com, plateforme de recherche d'offres de stage et d'alternance en France.

Permet à n'importe quel agent IA compatible MCP (Claude, ChatGPT, Gemini...) de rechercher des offres d'emploi directement dans la conversation.

Endpoint

https://mcp.iquesta.com/api/mcp

Protocole : MCP 2024-11-05 · Transport : Streamable HTTP · Stack : Laravel 10 / PHP 8.1

Tools disponibles

ToolDescription
search_jobsRecherche des offres par mots-clés (titre), descriptif de l'annonce, région, discipline, matière, type de contrat
get_jobRécupère le détail complet d'une offre par son ID
list_filtersListe les valeurs possibles pour les filtres (régions, disciplines, matières, types de contrat)

Note : le tool get_similar_jobs est temporairement désactivé — l'endpoint API correspondant n'existe pas encore côté iQuesta. Il sera réactivé une fois développé.

Paramètres de search_jobs
ParamètreTypeDescription
termstringMots-clés recherchés dans le titre de l'annonce
descriptionstringMots-clés recherchés dans le texte complet de l'annonce (missions, compétences requises...)
disciplinesintegerID de discipline (secteur large), obtenu via list_filters(filter='disciplines')
matieresinteger[]Liste d'IDs de matières (plus granulaire que disciplines), obtenue via list_filters(filter='matieres'). Ex : 27 = "Informatique - Développement"
regionsintegerID de région française, obtenu via list_filters(filter='regions')
contractsstringID du type de contrat : 1 (Stage), 2 (Alternance), -4 (Emploi), -5 (Job étudiant)
beginintegerMois de début souhaité (1-12)
durationintegerDurée maximale de la mission en mois
limitintegerNombre maximum de résultats (défaut : 10, max recommandé : 20)

Au moins un des paramètres term, description ou matieres est requis.

disciplines (16 valeurs, secteurs larges) et matieres (69 valeurs, plus précises) sont deux niveaux de granularité indépendants — utiliser matieres pour un filtrage fin (ex : "Développement web" plutôt que "Informatique").

Exemples d'utilisation

Initialisation
curl -X POST https://mcp.iquesta.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'
Liste des tools
curl -X POST https://mcp.iquesta.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'
Recherche d'offres par titre et région
curl -X POST https://mcp.iquesta.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "search_jobs",
      "arguments": {
        "term": "développeur",
        "regions": 10,
        "contracts": "1"
      }
    }
  }'
Recherche par matière et descriptif
curl -X POST https://mcp.iquesta.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 5,
    "method": "tools/call",
    "params": {
      "name": "search_jobs",
      "arguments": {
        "description": "Python",
        "matieres": [27]
      }
    }
  }'
Lister les filtres disponibles
curl -X POST https://mcp.iquesta.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": { "name": "list_filters", "arguments": { "filter": "all" } }
  }'

Configuration côté client

Claude.ai / Claude Desktop

Ajouter dans les paramètres de connecteurs :

{
  "mcpServers": {
    "iquesta": {
      "url": "https://mcp.iquesta.com/api/mcp"
    }
  }
}

À propos d'iQuesta

iQuesta.com référence des milliers d'offres de stage et d'alternance en France, à destination des étudiants et jeunes diplômés.

Licence

MIT

الأسئلة الشائعة

ما هو io.github.iQuesta/MCP-iQuesta؟

Recherche d'offres de stage et d'alternance en France via le réseau iQuesta.com

كيف أثبّت io.github.iQuesta/MCP-iQuesta؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http mcp-iquesta 'https://mcp.iquesta.com/api/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.iQuesta/MCP-iQuesta إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.iQuesta/MCP-iQuesta مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.iQuesta/MCP-iQuesta؟

ينشره iQuesta. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.