convez.ai
MCP ServerDados & AnalyticsIntermediário
malkreide

SECO Labor Market MCP

malkreide/seco-labor-mcp

Dados do mercado de trabalho suíço via MCP sem API key

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que conecta modelos de IA a dados do mercado de trabalho suíço, incluindo taxas de desemprego, buscadores de emprego e posições abertas. Alimentado por SECO e opendata.swiss, sem necessidade de autenticação, idealmente para análise de tendências laborais e planejamento educacional.

Instalação

$npx convez-ai malkreide/seco-labor-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
71%
Último commit
há 5 dias
Versão
v0.5.0
Issues abertas
0
Contribuidores
2

Casos de uso

  • Análise de tendências de desemprego e ocupações por cantão
  • Planejamento educacional e orientação profissional (vocational guidance)
  • Monitoramento automatizado do mercado laboral suíço

Veredito

Ferramenta bem estruturada e documentada para integrar dados laborais suíços em workflows de IA. Atende nicho específico (contexto CH) com dados públicos e sem autenticação, ideal para pesquisa e análise educacional.

README

A tradução para o português deste README ainda está na fila.

🇨🇭 Part of the Swiss Public Data MCP Portfolio

💼 SECO Labor Market MCP Server

CI PyPI Python 3.11+ MCP No Auth Required License: MIT

🌐 English | Deutsch

An MCP (Model Context Protocol) server for Swiss labor market data from SECO (Staatssekretariat für Wirtschaft) and AMSTAT via opendata.swiss.


Overview

This server connects AI models to Swiss labor market statistics — unemployment rates, job seekers, open positions, youth unemployment, and occupational breakdowns — all without requiring an API key.

Primary audiences:

  • 🏫 Schulamt / Education planning — youth unemployment, vocational guidance data
  • 📊 Research & analysis — labor market trends, cantonal comparisons
  • 🤖 AI agents — automated labor market monitoring and reporting

Anchor query:
"Welche Berufsgruppen haben im Kanton Zürich die höchste Jugendarbeitslosigkeit, und welche Lehrberufe unterliegen der Stellenmeldepflicht?" → More use cases by audience →


Data Sources (Phase 1 — No Auth Required)

SourceDescriptionStatus
opendata.swissCKAN metadata catalog with SECO dataset CSVs✅ Live
arbeit.swissMonthly press reports (PDF, structured URL pattern)✅ Live
amstat.chAMSTAT reference portal⚠️ JavaScript SPA, no public REST API

Architecture

┌─────────────────────────────────────────────────────┐
│                  seco-labor-mcp                     │
│                                                     │
│  ┌─────────────┐    ┌──────────────────────────┐   │
│  │  FastMCP    │    │      9 MCP Tools         │   │
│  │  Server     │◄──►│  seco_search_datasets    │   │
│  │  (stdio /   │    │  seco_get_dataset        │   │
│  │   SSE)      │    │  seco_get_unemployment_* │   │
│  └─────────────┘    │  seco_get_youth_*        │   │
│         │           │  seco_get_job_seekers    │   │
│         ▼           │  seco_get_open_positions │   │
│  ┌─────────────┐    │  seco_get_monthly_url    │   │
│  │  httpx      │    │  seco_list_cantons       │   │
│  │  async      │    └──────────────────────────┘   │
│  └──────┬──────┘                                   │
└─────────┼───────────────────────────────────────────┘
          │
          ▼
  ┌───────────────────────────────────┐
  │  opendata.swiss CKAN API          │
  │  https://opendata.swiss/api/3/    │
  │  action/package_search            │
  │  action/package_show              │
  └───────────┬───────────────────────┘
              │
              ▼
  ┌───────────────────────────────────┐
  │  SECO Data Resources              │
  │  CSV / XLSX / PDF Downloads       │
  │  (monthly labor market data)      │
  └───────────────────────────────────┘

Tools

ToolDescriptionKey Use Case
seco_search_datasetsSearch SECO datasets on opendata.swissDiscovery
seco_get_datasetFull metadata + download links for a datasetData access
seco_get_unemployment_overviewNational/cantonal unemployment figuresLabor market overview
seco_get_youth_unemploymentYouth unemployment (15–24 year olds)🎓 Berufswahlberatung
seco_get_job_seekersStellensuchende (broader than unemployed)Training demand
seco_get_open_positionsOpen positions — leading indicatorSector analysis
seco_get_unemployment_by_occupationBreakdown by Berufshauptgruppe🎓 Vocational guidance
seco_get_monthly_report_urlGenerate/verify PDF report URLSource access
seco_list_cantonsAll 26 canton codes and namesUtility

Installation

Claude Desktop (stdio)

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "seco-labor": {
      "command": "uvx",
      "args": ["seco-labor-mcp"]
    }
  }
}

Cloud / SSE

pip install seco-labor-mcp
MCP_TRANSPORT=sse PORT=8000 seco-labor-mcp

The SSE server binds to 127.0.0.1 (loopback) by default to prevent NeighborJack on shared networks. For container deployments where you actually need to accept traffic from outside the container, set HOST=0.0.0.0 explicitly — ideally in your Dockerfile / orchestrator config, and only behind an upstream proxy or firewall:

HOST=0.0.0.0 MCP_TRANSPORT=sse PORT=8000 seco-labor-mcp   # container only

Development

git clone https://github.com/malkreide/seco-labor-mcp.git
cd seco-labor-mcp
pip install -e ".[dev]"
pytest tests/ -m "not live" -v

Usage Examples

Search for youth unemployment data

Tool: seco_search_datasets
Input: { "query": "Jugendarbeitslosigkeit Alter", "limit": 5 }

Get cantonal unemployment for Zürich

Tool: seco_get_unemployment_overview
Input: { "canton": "ZH", "response_format": "markdown" }

Get monthly report URL

Tool: seco_get_monthly_report_url
Input: { "year": 2026, "month": 2, "language": "de" }

Key Concepts

Arbeitslose vs. Stellensuchende

Eselsbrücke: Arbeitslose ⊂ Stellensuchende — Arbeitslose sind eine Teilmenge.

TermDefinitionDec 2025
ArbeitsloseRAV-registered, immediately available~149'000 (3.2%)
StellensuchendeAll RAV-registered (incl. training programs)~233'900

Youth Unemployment Seasonality

  • July/August: Sharp increase (school leavers without placements)
  • September/October: Decline (apprenticeship starts)
  • The residual that remains after the autumn decline signals structural need for bridge programs (Brückenangebote)

Stellenmeldepflicht (since 2020)

Occupations with ≥5% unemployment rate must be reported to the RAV before posting publicly. The list changes annually. This is directly relevant for vocational counseling — these professions have highest availability for Swiss job seekers.


Portfolio Synergies

ServerSynergy
swiss-statistics-mcpBFS population/employment data for deeper context
zurich-opendata-mcpCity of Zurich-level education and social data
swiss-snb-mcpEconomic context (GDP, wages) for labor market interpretation
fedlex-mcpALV (Arbeitslosenversicherung) legislative framework

Known Limitations

  • amstat.arbeit.swiss has no public REST API (JavaScript SPA) → workaround via CKAN
  • Occupational/sectoral detail requires CSV download from SECO resources
  • Monthly press report URL patterns may vary for older reports
  • Cantonal sub-municipal data not available at this level

Phase 2 roadmap:

  • Automatic CSV caching with 24h TTL
  • Direct XLSX parsing for cantonal breakdowns
  • Integration with zh-education-mcp for Schulamt-specific correlations

Data License

SECO data published on opendata.swiss is under Creative Commons CCZero (public domain).
Source: Staatssekretariat für Wirtschaft (SECO) — seco.admin.ch


🛡️ Safety & Limits

AspectDetails
AccessRead-only (readOnlyHint: true) — the server cannot modify or delete any data
Personal dataNo personal data — all sources are aggregated, anonymous public statistics
Rate limitsNo enforced external limits; server caps queries at 20 results by default; 30 s HTTP timeout
AuthenticationNo API keys required — opendata.swiss and arbeit.swiss are publicly accessible
LicensesSECO data under Creative Commons CCZero (public domain)
Terms of ServiceSubject to ToS of: opendata.swiss, SECO, arbeit.swiss
GDPR / DSGFully compliant — no personal data transmitted or stored; all data is official public statistics

Contributing

See CONTRIBUTING.md for development guidelines.


Security

See SECURITY.md for the security posture and how to report a vulnerability.


License

Released under the MIT License — Copyright © 2026 Hayal Oezkan.

Installation

Run via uv's uvx — no clone or manual install needed. Add to your MCP client config (mcpServers for Claude Desktop, Cursor and Windsurf; use a top-level servers key for VS Code in .vscode/mcp.json):

{
  "mcpServers": {
    "seco-labor-mcp": {
      "command": "uvx",
      "args": [
        "seco-labor-mcp"
      ]
    }
  }
}
Ver o original no GitHub

Bom para

Relacionados