Verifică firme RO din codul tău

Un singur API REST + server MCP. Aceleași date oficiale (ANAF, Registrul Comerțului, Ministerul Finanțelor, portalul instanțelor, BPI) — curate, datate și citabile, fără să scrii scraper. Profil de firmă gratuit; verdictul complet de risc, per verificare.

De ce Firmoscop, nu un scraper propriu: date deduplicate cu CUI ca cheie, fiecare câmp cu sursă + dată, verdict pe reguli fixe pe care ți le arătăm (nu un scor pe care nu-l poți verifica) și un server MCP pe care agentul îl conectează cu OAuth, nu cu o cheie lipită în config.

Autentificare

Cheie fk_… în headerul Authorization: Bearer. Generează-ți una în contul de dezvoltator — 10 credite gratuite pe lună, fără card.

Authorization: Bearer fk_CHEIA_TA

Prețuri

Cauți gratis, plătești raportul complet. 1 credit per raport, indiferent ce verdict iese; contul gratuit are 10 credite pe lună, reîmprospătate la începutul fiecărei luni (ce nu folosești nu se reportează). Peste plafon: pachete de 10 / 50 / 250 / 1000 de credite — de la 1,09 lei creditul (TVA inclus), sub prețul pe raport al oricărui competitor. 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 din asistentul AI, 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. Fără abonament obligatoriu. Prețuri citibile de mașină la /api/v1/pricing.

Limite

30 cereri/min per cheie, 60/min per IP. Fiecare răspuns întoarce X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. Ai nevoie de mai mult? Scrie-ne pentru un plan enterprise.

Quickstart

REST — verdict de risc (1 credit)

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

REST — profil de firmă (gratis)

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

REST — verificare în lot (1 credit / firmă)

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

JavaScript / TypeScript

const r = await fetch("https://firmoscop.ro/api/v1/verify/16269340", {
  headers: { Authorization: `Bearer ${process.env.FIRMOSCOP_KEY}` },
});
const report = await r.json();

Python

import os, requests
r = requests.get(
    "https://firmoscop.ro/api/v1/verify/16269340",
    headers={"Authorization": f"Bearer {os.environ['FIRMOSCOP_KEY']}"},
)
report = r.json()

MCP — conectează un agent (Claude, ChatGPT)

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

Endpoint-uri

Specificația completă: OpenAPI · llms.txt

Webhook-uri (monitorizare push)

Pune o firmă în watchlist și primești un POST semnat când i se schimbă verdictul (re-verificare zilnică). Livrare cu semnătură HMAC, retry exponențial și dead-letter.

curl -X POST https://firmoscop.ro/api/v1/webhooks \
  -H "Authorization: Bearer fk_CHEIA_TA" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://exemplu.ro/hook","events":["verdict.changed"]}'

Verifici semnătura din headerul X-Firmoscop-Signature: sha256=HMAC_SHA256(secret, timestamp + "." + body), cu X-Firmoscop-Timestamp. Jurnalul livrărilor: GET /api/v1/webhooks/{id}/deliveries.

Termeni

Datele sunt din surse publice, orientative, la data verificării — nu garanție de plată sau consultanță. Revânzarea bulk a datelor e interzisă (ToS). Prelucrăm date publice despre firme și PFA-uri (confidențialitate).