Stavějte na Cold Leads
Cold Leads je CRM pro studené oslovování, které můžete řídit z kódu. Ověřujte e-mailové adresy před odesláním, posílejte leady z libovolného formuláře či systému, posouvejte kontakty trychtýřem a dejte svému AI agentovi stejné nástroje přes MCP. Čisté JSON, jedna hlavička pro autentizaci a specifikace OpenAPI 3.1 pro generování klientů.
- OpenAPI 3.1
- ·Autentizace x-api-key
- ·120 požadavků za minutu na klíč
- ·Hostovaný MCP server
- ·SDK s licencí MIT na GitHubu
curl -X POST https://coldleads.app/api/v1/verify \
-H "x-api-key: $COLDLEADS_API_KEY" \
-d '{"email":"jane@example.com"}'{
"email": "jane@example.com",
"status": "valid",
"score": 75,
"reasons": ["smtp_unreachable"],
"mx": "mx.example.com",
"catch_all": null,
"disposable": false,
"role": false
}Ilustrativní odpověď. Kódy důvodů říkají, zda byla zkontrolována i samotná schránka.
120/min
požadavků na klíč, jedna autentizační hlavička
14
nástrojů MCP pro Claude, ChatGPT a Cursor
5 dní
zkušební období zdarma s API na tarifu Business
Vyberte rozhraní, které sedí
REST API
Ověřte jednu adresu nebo seznam (hromadné úlohy), hledejte kontakty ve vlastním CRM, čtěte stav kreditů. Specifikace OpenAPI 3.1 pro generování kódu a pro agenty, kteří importují nástroje ze specifikace.
Specifikace OpenAPI 3.1Hooky pro leady a fáze
Webový klíč (lk_…) z libovolného formuláře udělá zdroj leadů a může po zvoleném zpoždění spustit automatickou kampaň. Hook fáze označí kontakt jako zákazníka, když váš fakturační systém či CRM uzavře obchod.
Hostovaný MCP server
https://coldleads.app/api/mcp dává Claude, ChatGPT, Cursoru a dalším MCP klientům 14 nástrojů: import a úpravy kontaktů, ověřování adres, psaní šablon, příprava kampaní a jejich spuštění po vašem schválení, čtení odpovědí. OAuth nebo tajný klíč.
Cold Leads pro AI agentyNode.js SDK a stdio MCP
Typovaný klient pro Node 20 a novější a lokální MCP server pro Claude Desktop, Cursor a VS Code. Open source, licence MIT, instalace přímo z GitHubu.
github.com/anttka4cz/coldleads-node-sdkOd registrace k prvnímu volání za pár minut
Zaregistrujte se
Vytvořte účet přes Google nebo e-mailový odkaz. Spusťte 5denní zkušební období zdarma na tarifu Business a vyzkoušejte API s 25 kredity (nutná karta, zrušit lze kdykoli před jeho koncem).
Vytvořte klíč
Nastavení → API. Tajný klíč (sk_…) pro váš server, webový klíč (lk_…) pro formuláře na webu. Tajné klíče se ukládají jako hash, zobrazí se jednou a lze je pozastavit, otočit nebo smazat.
Zavolejte API
Pošlete klíč v hlavičce x-api-key a zavolejte libovolný endpoint níže. Chyby jsou JSON s krátkým kódem, např. rate_limited, no_credits nebo bad_input.
# 1. Verify an address (1 credit)
curl -X POST https://coldleads.app/api/v1/verify \
-H "x-api-key: $COLDLEADS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"jane@example.com"}'
# 2. Capture a lead from any form (website key lk_…, safe to ship in HTML)
curl -X POST "https://coldleads.app/api/hooks/lead?key=$COLDLEADS_SITE_KEY" \
-d email=jane@example.com -d name="Jane Doe"
# 3. Move a contact along the funnel when the deal closes
curl -X POST https://coldleads.app/api/hooks/stage \
-H "x-api-key: $COLDLEADS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"jane@example.com","stage":"customer"}'
# Node.js SDK and MCP server (installed from GitHub)
npm install --allow-git=root github:anttka4cz/coldleads-node-sdk
npx -y --allow-git=root github:anttka4cz/mcp-server-coldleadsProměnné prostředí nahraďte svými klíči. Adresy jsou ilustrativní.
Odpověď ověření obsahuje stav (valid, risky nebo invalid), skóre, kódy důvodů, MX server a příznak catch_all. Kódy důvodů říkají, zda byla zkontrolována i samotná schránka.
Proč u nás vývojáři zůstávají
Čisté JSON přes HTTPS, jedna autentizační hlavička, chyby s krátkými kódy — ke startu nepotřebujete SDK.
Každý klíč má vlastní limit požadavků a čítač využití a lze ho pozastavit či otočit bez dotyku ostatních.
Stejný stroj pohání vaše vlastní kampaně: na adresy ověřené jako neplatné se nikdy neposílá a kampaně odcházejí z vaší schránky Gmail, Microsoft 365 nebo SMTP.
AI agenti pracují se schválením: připraví koncept kampaně a spustí ji až poté, co člověk potvrdí šablonu i publikum.
Agent může začít i bez klíče: POST /api/agent/provision vrátí platební odkaz pro lidského majitele a claim token.
Ceny
Webové klíče fungují na každém tarifu. API s tajným klíčem (ověřování, vyhledávač, hledání kontaktů, hook fáze) a MCP jsou součástí tarifu Business: $99 měsíčně včetně 10,000 kreditů za měsíc. Další kredity stojí $5 za 1 000.
Nejdřív vyzkoušejte: 5denní zkušební období zdarma na tarifu Business zahrnuje API v rámci limitů zkušebního období (25 kreditů). Noví zákazníci, kteří si předplatné zvolí do 24 hodin od registrace, dostanou místo zkušebního období −30 % na první platbu — obojí dohromady nejde.
Limity
- 120 požadavků za minutu na klíč.
- 5 paralelních hromadných úloh, až 5 000 adres na úlohu.
- 1 kredit za ověřenou adresu nebo volání vyhledávače; výsledky se ukládají 30 dní a opakovaná kontrola stále stojí kredit.
- Webové klíče (lk_…) umí jen vytvářet kontakty, s denním stropem na klíč.
Co to není
Recepty
Používejte Cold Leads z Cursoru, Claude Desktop a Windsurfu přes MCP
Propojte Cold Leads MCP nebo Node SDK pro import kontaktů, chaty, kampaně, schválený outreach a webové poptávky.
Hromadné ověřování e-mailů v n8n s Google Sheets
Workflow n8n k importu: načte Google Sheet, pošle až 5 000 adres do hromadné úlohy Cold Leads, hlídá ji, roztřídí řádky podle stavu a zapíše výsledky zpět.
Ověřte leady v Make.com dřív, než se dostanou do kampaně v Instantly
Scénář v Make.com, který každý nový lead ověří přes API Cold Leads a do kampaně v Instantly přidá jen platné adresy pomocí Instantly API v2.
Ověřte CSV s 50 000 řádky v Pythonu s asyncio a httpx
Kompletní skript s asyncio a httpx pro hromadné API Cold Leads: úlohy po 5 000, pět naráz, dotazy na stav, ošetření 429 a 402, obnovitelný zápis do CSV.
Přechod s ověřováním e-mailů z Hunteru nebo Apolla na Cold Leads
Převeďte Email Verifier a Email Finder od Hunteru na API Cold Leads pole po poli, zjistěte, co z dat Apolla nemá obdobu, a spočítejte náklady na Cold Leads.
Předplatné, které zahájí agent a schválí člověk
AI agent bez klíče požádá o předplatné Cold Leads Business, vlastník (člověk) ho schválí a zaplatí na Stripe a agent si jednou vyzvedne API klíč.
FAQ pro vývojáře
Potřebuji kartu na vyzkoušení API?
Ano. 5denní zkušební období zdarma vyžaduje kartu a před jeho koncem lze zrušit; během něj se nic neúčtuje. Tarif zdarma neexistuje.
Který tarif obsahuje API?
Business ($99 měsíčně, 10,000 kreditů). Webové klíče pro formuláře fungují na každém tarifu. Během zkušebního období na Business funguje API v rámci jeho limitů.
Mohu klienta vygenerovat ze specifikace?
Ano, /api/v1/openapi.json je dokument OpenAPI 3.1. Oba hooky jsou obyčejná HTTP volání popsaná na této stránce.
Existuje SDK?
Typované SDK pro Node.js (Node 20 a novější) a MCP server pro lokální klienty, obojí s licencí MIT na GitHubu. Jiné jazyky mohou používat HTTP API přímo.
Může se AI agent zaregistrovat sám?
Agent zavolá POST /api/agent/provision s e-mailem majitele. Dostane platební odkaz Stripe pro lidského majitele a claim token; po zaplacení majitelem agent jednou obdrží svůj klíč.
Co se stane, když mi dojdou kredity?
Volání vrátí chybu 402 no_credits se zbývajícím zůstatkem. Kredity se obnovují měsíčně a další balíčky stojí $5 za 1 000.
Připraveni stavět?
Vytvořte účet, vezměte klíč a první volání uděláte za pár minut.
Získat API klíč