API & MCP pentru dezvoltatori și agenți AI

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 credite gratuite pe lună · fără card · căutarea și sumarul nu consumă credite

Verdict, nu date brute

Verde / galben / roșu, cu fiecare motiv explicat și sursa lui. Aceleași reguli ca în interfața web, pe care ți le arătăm — nu un scor pe care nu-l poți verifica.

Nativ pentru agenți AI

Server MCP (streamable HTTP) + llms.txt. Conectezi Claude sau ChatGPT într-o linie, cu login din client — fără cheie de copiat.

Date curate, citabile

Deduplicate pe CUI, fiecare câmp cu sursă și dată (ANAF, ONRC, Ministerul Finanțelor, instanțe, BPI). Nu scrii și nu întreții niciun scraper.

Monitorizare push

Pune firme pe watchlist și primești un webhook semnat când li se schimbă verdictul. Livrare cu HMAC, retry și dead-letter.

Prețuri de dezvoltator

Începe gratuit. Plătești 1 credit per raport complet cerut programatic, indiferent ce verdict iese. Pe site, un om cu cont gratuit primește raportul fără credit — creditele măsoară automatizarea, nu datele.

Gratuit
0 lei

Căutare, profil de firmă, bilanțuri, contracte publice și grup de firme. Fără credit, fără card.

Raport complet
1 credit / raport complet · de la 1,09 lei creditul

Verdictul final, tot ce l-a determinat (cu sursă și dată), dosarele din instanță și explicația. Re-verificarea în 7 zile e fără cost. Pachete de 10 / 50 / 250 / 1000 de credite. Un credit = o pagină de listă de 25 de firme. La descărcarea în Excel, primele 50 de rânduri sunt gratuite, apoi un credit la 25 de firme. O verificare automată, adică raportul complet cerut din Google Sheets, din programul tău sau dintr-un agent conectat cu cheie API, costă un credit; căutarea și profilul firmei rămân gratuite. Creditele cumpărate nu expiră: stau în soldul tău și se folosesc după ce ai consumat plafonul lunar al planului. Le cumperi din contul tău, de unde îți iei și cheia.

Prețuri citibile de mașină la /api/v1/pricing. Tabel complet, comparație cu competitorii și toate endpoint-urile în documentație.

Generează-ți cheia

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

Confirmă-ți adresa (codul de pe email sau Google) înainte să generezi cheia: la prima confirmare a adresei, cheile, conectările OAuth și webhook-urile făcute înainte se revocă. Dacă ai generat cheia înainte, generează alta după confirmare.

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, fișa completă a firmei, bilanțuri pe ani, restanțe ANAF, contracte publice, istoric, firme legate, comparație, verdict de risc, liste de firme și urmărire. Conectat cu login-ul contului, verdictul e gratuit, ca pe site.

… 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.

Fluxuri gata de lipit

Trei rețete pe care le montezi în 5 minute — cu agentul tău AI sau cu un cron. Fiecare folosește exact endpoint-urile de mai sus, nimic special.

Fluxul 01 · Furnizor nou → verificare înainte de PO

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.

Fluxul 02 · Portofoliul de clienți, re-verificat lunar

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ă.

Fluxul 03 · Alertă push când se schimbă verdictul

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.

Întrebări frecvente

Cât durează să integrez Firmoscop?

Minute. Generezi o cheie gratuit din cont (fără card), o pui în headerul Authorization: Bearer și faci primul apel. Pentru un agent AI, o singură comandă `claude mcp add` conectează serverul MCP. Ai exemple gata de copiat în REST, JavaScript, Python și MCP.

Cu ce clienți funcționează serverul MCP?

Cu orice client MCP peste streamable HTTP — Claude (Desktop, Code), ChatGPT și aplicațiile tale. Agentul primește fișa completă a oricărei firme, bilanțurile, restanțele ANAF, contractele publice, verdictul de risc, listele de firme și urmărirea, și poate chiar să-și facă singur top-up de credite, fiindcă prețurile sunt citibile de mașină la /api/v1/pricing și în llms.txt.

Trebuie să copiez o cheie API ca să conectez MCP-ul?

Nu. Adaugi https://firmoscop.ro/mcp în client (de ex. „Add custom connector” în Claude) și clientul te trimite pe firmoscop.ro să te loghezi — apeși Autorizează și ești conectat (OAuth cu PKCE, standardul MCP). Cheia fk_ rămâne pentru integrări headless (scripturi, CI, agenți fără browser).

Trebuie card la înscriere?

Nu. Contul gratuit are 10 credite pe lună, fără card. Plafonul se reîmprospătează la începutul fiecărei luni, iar ce nu folosești nu se reportează. Căutarea, profilul de firmă, bilanțurile, contractele publice și grupul de firme rămân gratuite oricând, fără să consume nimic.

Cât costă la volum?

Raportul complet costă 1 credit, indiferent ce verdict iese — de la 1,09 lei creditul (TVA inclus) la pachetul de 1000 de credite, sub prețul pe raport al oricărui competitor. Creditele cumpărate nu expiră: stau în sold și se folosesc după alocația lunară. Nu e abonament obligatoriu, iar re-verificarea aceleiași firme în 7 zile nu consumă credit. Pentru volume mari, scrie-ne pentru un plan enterprise.

De unde vin datele?

Exclusiv din surse publice oficiale (ANAF, Registrul Comerțului, Ministerul Finanțelor, portalul instanțelor, BPI), citite la sursă pe CUI. Fiecare câmp poartă sursa și data snapshot-ului — date deduplicate și datate, nu agregate de la alți agregatori. Aceleași date duc mereu la același verdict, iar regulile ți le arătăm — nu e un scor pe care nu-l poți verifica.

Sigiliu embed

Pune sigiliul „Verificat pe Firmoscop” pe site-ul tău, pe facturi sau pe pagina „despre noi”. Se re-desenează zilnic din verdictul curent — nu e o poză statică, ci o afirmație vie.

Preview
Sigiliu Firmoscop — exemplu pe fundal deschis
Sigiliu Firmoscop — exemplu pe fundal închis

Varianta „pastilă” (224 × 56 px). Există și varianta „bandă” (252 × 34 px) — vezi parametrii de mai jos.

Cod de inserat

Înlocuiește CUI cu CUI-ul firmei tale. Sigiliul se încarcă ca imagine SVG; lasă atributele width și height ca să nu sară layout-ul.

<a href="https://firmoscop.ro/firma/CUI" target="_blank" rel="noopener">
  <img src="https://firmoscop.ro/badge/CUI.svg"
       alt="Verificat pe Firmoscop"
       width="224" height="56">
</a>

Parametri opționali

?d=compactVarianta bandă (252 × 34 px) — pentru subsoluri înguste și semnături
?t=darkTema închisă — pentru site-uri cu fundal închis
?d=compact&t=darkSe pot combina

Pagina completă cu selector de variante și preview per firmă: https://firmoscop.ro/badge/CUI

Referință completă

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