Integrări API + MCP — SEAP Monitor

1. Generează cheia API

Cheia se generează gratuit în contul tău. Necesar plan activ (Start trial, Pro sau Premium).

Conectează-te în contul tău

Mergi la /cont și autentifică-te cu magic link-ul primit pe email.

Deschide profilul

Click pe Date facturare în meniu — secțiunea „Chei API + MCP" e în partea de jos.

Generează și salvează cheia

Apasă „Generează cheie nouă", dă-i un nume (ex: „Claude Desktop"), apoi copiază imediat cheia — nu o mai poți recupera după ce închizi pagina.

2. Conectează clientul tău AI

Alege ce client folosești. Toate exemplele de mai jos sunt copy-paste-able.

ℹ Notă: MCP server-ul rulează local pe calculatorul tău (nu pe server-ul nostru). Tu îl descarci ca fișier Python (mcp_server.py) și Claude Desktop / Cursor îl pornește automat când deschizi aplicația. Cheia API o folosește local pentru a apela REST API-ul nostru.

Editează fișierul de configurare Claude Desktop:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Adaugă (sau pune-l în mcpServers existent):

{
  "mcpServers": {
    "seap-monitor": {
      "command": "python",
      "args": ["C:\\path\\to\\seap-monitor\\mcp_server.py"],
      "env": {
        "SEAP_API_KEY": "sk_a3f2b8e1...",
        "SEAP_BASE_URL": "https://monitor.redmoonlightexperts.ro"
      }
    }
  }
}

După salvare, repornește Claude Desktop. În chat vei vedea iconița 🔌 cu „seap-monitor" listat. Acum poți întreba lucruri precum:

„Care sunt anunțurile noi pe CPV 45 din ultimele 7 zile cu valoare peste 100.000 lei?"
„Arată-mi profilul autorității MAI (CUI 4267095) — top operatori câștigători"
„Ce anomalii critical au apărut în piață săptămâna asta?"
„Care sunt CPV-urile dominante pentru autoritățile din Sibiu?"

În Cursor, deschide Settings → MCP, sau editează direct ~/.cursor/mcp.json:

{
  "mcpServers": {
    "seap-monitor": {
      "command": "python",
      "args": ["/path/to/seap-monitor/mcp_server.py"],
      "env": {
        "SEAP_API_KEY": "sk_a3f2b8e1...",
        "SEAP_BASE_URL": "https://monitor.redmoonlightexperts.ro"
      }
    }
  }
}

Pentru Cline și Continue configurația e similară — verifică documentația lor pentru calea exactă a fișierului mcp.json.

Pentru ChatGPT (versiune Plus / Team / Enterprise), creează un GPT custom cu Actions:

În ChatGPT → My GPTs → Create
În tab-ul Configure, scroll jos până la Actions
Apasă „Import from URL" și introdu: https://monitor.redmoonlightexperts.ro/api/openapi.json
La Authentication selectează API Key → Auth Type: Bearer → introdu cheia sk_...
Salvează GPT-ul. Gata — îl poți întreba direct despre licitații, autorități, anomalii.

REST API standard, autentificare cu Bearer token:

# Listă anunțuri pe CPV 45 (construcții) din ultimele 30 zile
curl https://monitor.redmoonlightexperts.ro/api/v1/notices?cpv=45 \
  -H "Authorization: Bearer sk_a3f2b8e1..."

# Profile autoritate (după CUI sau nume)
curl https://monitor.redmoonlightexperts.ro/api/v1/authorities/4267095 \
  -H "Authorization: Bearer sk_a3f2b8e1..."

# Semnale anomalii cu severitate critică
curl "https://monitor.redmoonlightexperts.ro/api/v1/anomalies?min_severity=critical" \
  -H "Authorization: Bearer sk_a3f2b8e1..."

Documentație OpenAPI interactivă: /api/docs (Swagger UI) · ReDoc: /api/redoc

3. Endpoint-uri disponibile

Toate endpoint-urile au prefixul /api/v1 și necesită header Authorization: Bearer sk_....

Metodă	Endpoint	Descriere
GET	`/api/v1/me`	Info despre cheia API + abonament curent (rate limit rămas)
GET	`/api/v1/notices`	Caută anunțuri (filtre: `q, cpv, authority, notice_type, date_from, date_to, min_value, page, page_size`)
GET	`/api/v1/notices/{id}`	Detalii anunț specific după ID intern
GET	`/api/v1/authorities`	Caută autorități (parametrii: `q, limit`)
GET	`/api/v1/authorities/{slug}`	Profile autoritate (CUI sau nume) — stats, top CPV, operatori, contracte recente
GET	`/api/v1/operators/{slug}`	Profile operator economic — câștiguri, autorități, CPV-uri
GET	`/api/v1/anomalies`	Semnale anomalii (filtre: `category, min_severity`)
GET	`/api/v1/cpv`	Catalog CPV (parametrii: `q, limit`)
GET	`/api/v1/stats`	Statistici globale piață

4. Limite rate (cereri per oră, per cheie)

Plan	Limită	Notes
Start (trial)	20 req/oră	Pentru testare. La depășire: HTTP 429.
Profesional	100 req/oră	Suficient pentru integrări CRM mici/medii.
Premium	1.000 req/oră	Pentru integrări complexe + chat MCP intens.
Business (în curând)	5.000 req/oră	Pentru multi-utilizator + automation heavy.

Sliding window de 1h. Header-ele X-RateLimit-Remaining și Retry-After îți spun când poți relua.

Vrei să încerci?

Generează o cheie API gratuit în contul tău (necesar trial activ de 14 zile). Setup MCP în Claude Desktop e <5 minute.

Mergi la chei API

Ai nevoie de ajutor?

Implementare API/MCP în echipa ta? Onboarding asistat? Pachet de integrare custom? Vorbim.

Solicită ofertă

Integrări — API + MCP