Adaugă verificarea firmelor din România în produsul tău

Un apel și primești verdictul verde / galben / roșu pentru orice firmă din România, structurat și cu sursele citate. Sau conectezi un agent AI prin MCP, într-o linie. Fără scraper de întreținut, fără abonament.

10 rapoarte complete la înregistrare · fără card · căutarea și sumarul rămân gratuite

Generează-ți cheia

Intră în cont și generează o cheie fk_… pentru aplicații și agenți AI. O pui în headerul Authorization: Bearer.

Cheia și creditele se gestionează în cont, în secțiunea Chei API — de acolo o rotești și vezi ce ți-a mai rămas.

Conectează un agent (MCP)

claude mcp add --transport http firmoscop https://firmoscop.ro/mcp \
  --header "Authorization: Bearer CHEIA_TA"

Compatibil cu orice client MCP (streamable HTTP). Unelte: căutare firmă, verificare firmă.

… sau apelează direct (REST)

curl https://firmoscop.ro/api/v1/verify/16269340 \
  -H "Authorization: Bearer CHEIA_TA"

Exemple în JavaScript, Python și verificare în lot: vezi quickstart-ul complet.

Agentul tău de achiziții (Claude, sau orice client MCP) verifică orice furnizor înainte să emită comanda. Lipește instrucțiunea în system prompt / CLAUDE.md, după ce ai conectat serverul MCP de mai sus:

Înainte de orice comandă sau contract cu un furnizor:
1. Află CUI-ul (dacă ai doar numele, cheamă cauta_firma).
2. Cheamă verifica_firma cu CUI-ul.
3. Verdict ROȘU → oprește comanda; escaladează la om, cu semnalele
   și sursele citate din răspuns.
4. GALBEN → propune plată la livrare sau limită de credit redusă;
   atașează semnalele la comandă.
5. VERDE → continuă; notează în comandă data verificării.
Nu decide peste verdict: e determinist, din surse oficiale, citabile.

Costul e previzibil: 1 credit per firmă trecută prin flux, indiferent ce iese. Căutarea și sumarul, dacă vrei doar un triaj rapid, rămân gratuite.

Un cron care trece toți clienții cu termen de plată prin verdict, o dată pe lună. Până la 20 de CUI-uri per apel — pentru liste mai lungi, împarți în loturi:

curl -X POST https://firmoscop.ro/api/v1/verify/batch \
  -H "Authorization: Bearer CHEIA_TA" \
  -H "Content-Type: application/json" \
  -d '{"cuis": ["16269340", "14399840", "6719950"]}'

Răspunsul are verdictul per CUI + creditsRemaining. Re-verificarea aceleiași firme în 7 zile nu consumă credit, deci un cron zilnic pe același portofoliu costă cât o singură trecere pe săptămână.

Fără polling: pui firmele pe watchlist și primești un webhook semnat când verdictul li se schimbă — numai bun de dus în Slack, ERP sau la agentul tău.

# 1. Urmărește firma
curl -X POST https://firmoscop.ro/api/v1/watchlist \
  -H "Authorization: Bearer CHEIA_TA" \
  -H "Content-Type: application/json" -d '{"cui": "16269340"}'

# 2. Înregistrează webhook-ul (secretul HMAC vine în răspuns, o singură dată)
curl -X POST https://firmoscop.ro/api/v1/webhooks \
  -H "Authorization: Bearer CHEIA_TA" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://exemplu.ro/hook", "events": ["verdict.changed"]}'

Livrare cu semnătură X-Firmoscop-Signature (HMAC-SHA256 pe timestamp.body), retry cu backoff și dead-letter. Watchlist-ul trimite oricum și alerte pe email — webhook-ul e pentru sisteme.

Referință completă

Ghid de integrare · Specificația OpenAPI · llms.txt · Prețuri (JSON)