Ceki.me API փաստաթղթեր

Արագ սկիզբ

Ceki-ի հետ սկսելու երկու եղանակ — ընտրեք ձեր աշխատանքային հոսքին համապատասխան ուղին։

Ուղի A — Ագենտի ինքնագրանցում MCP-ի միջոցով

Թույլ տվեք ձեր AI ագենտին ինքնուրույն գրանցվել որպես Ceki ագենտ՝ առանց ձեռքով կարգավորման։

1. Ավելացրեք MCP կոնֆիգը (նույնականացում չի պահանջվում)

{
  "mcpServers": {
    "ceki": {
      "url": "https://api.ceki.me/mcp/agent"
    }
  }
}

2. Խնդրեք ձեր ագենտին գրանցվել

"Գրանցիր ինձ որպես Ceki ագենտ։ Անուն՝ my-agent։ Email՝ you@example.com"

3. Ագենտը կանչում է register-agent

Backend-ը պատասխանում է api_key-ով և ուղարկում է 6-նիշանոց հաստատման կոդ նշված հասցեին։

4. Հաստատեք email-ը

"Հաստատիր իմ email-ը 123456 կոդով"

5. Վերամիացրեք MCP-ն նույնականացմամբ

{
  "mcpServers": {
    "ceki": {
      "url": "https://api.ceki.me/mcp/agent",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

6. Համալրեք ձեր դրամապանակը

Խնդրեք ձեր ագենտին՝ «Ցույց տուր իմ դրամապանակը» (կանչում է get-wallet)։ Ավանդագրեք crypto այն wallet.deposit_address-ի վրա, որը հայտնվում է պատասխանում։

7. Պատրաստ է

Կարգավիճակը դառնում է active — բոլոր գործիքները հասանելի են։ Սկսեք բրաուզերներ վարձել։

Ուղի B — Մարդն իր Dashboard-ի միջոցով

Գրանցվեք ձեռքով՝ վեբ-ինտերֆեյսի միջոցով, և ստեղծեք ագենտի բանալի։

1. Գրանցվեք ceki.me-ում (email + գաղտնաբառ + OTP)
2. Բացեք Dashboard → Agents
3. Սեղմեք Create Agent, լրացրեք ձևը, պատճենեք api_key-ը երկխոսության պատուհանից (ցուցադրվում է մեկ անգամ)
4. Տեղադրեք բանալին MCP կոնֆիգում (Authorization: Bearer ag_...)
5. Ավանդագրեք crypto Dashboard-ում ցուցադրված դրամապանակի հասցեին — կարգավիճակը կդառնա active

{
  "mcpServers": {
    "ceki": {
      "url": "https://api.ceki.me/mcp/agent",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Python SDK

Տեղադրեք SDK-ն և սկսեք բրաուզերներ վարձել մի քանի տող կոդով։

pip install ceki-sdk

import asyncio
import os
from ceki_browser import connect

async def main():
    client = await connect(os.environ["CEKI_API_KEY"])
    options = await client.search({"geo": "DE", "language": "en"})
    browser = await client.rent(options[0].schedule_id)

    await browser.navigate("https://example.com")
    snap = await browser.snapshot()
    print(snap.title)

    await browser.close()
    await client.close()

asyncio.run(main())

JavaScript SDK

Աշխատում է Node.js 18+-ի և ժամանակակից բրաուզերների հետ։

npm install @ceki/sdk

import { connect } from '@ceki/sdk';

const client = await connect(process.env.CEKI_API_KEY);
const options = await client.search({ geo: 'DE', language: 'en' });
const browser = await client.rent(options[0].schedule_id);

await browser.navigate('https://example.com');
const snap = await browser.snapshot();
console.log(snap.title);

await browser.close();
await client.close();

Command-line ինտերֆեյս

Երկու SDK-ները տեղադրում են մեկ ընդհանուր ceki CLI-ն ձեր PATH-ում։ Հրամանների հավաքածուն նույնն է՝ անկախ նրանից՝ Python-ից եք եկել, թե Node.js-ից — ընտրեք ձեր stack-ին համապատասխան տեղադրման ուղին։

Տեղադրում

Python՝

pip install ceki-sdk

Node.js՝

npm install -g @ceki/sdk

Տեղադրումից հետո գործարկեք ceki --help՝ համոզվելու համար, որ binary-ն գտնվում է PATH-ում։

Միջավայրի փոփոխականներ

Կոնֆիգուրացիան փոխանցվում է միջավայրի փոփոխականներով, ոչ թե flag-երով։ Սահմանեք դրանք ձեր shell-ում կամ .env-ում՝

Արագ սկիզբ

Հինգ հրաման՝ վարձելու, ղեկավարելու և անջատելու համար՝

export CEKI_API_KEY=ag_...

SCHEDULE=$(ceki search --limit 1 | jq -r '.[0].schedule_id')
SID=$(ceki rent --schedule $SCHEDULE | jq -r .session_id)
ceki navigate $SID https://example.com
ceki snapshot $SID -o snap.png
ceki stop $SID

CLI-ն լոկալ պահպանում է սեսիայի վիճակը — rent-ից հետո պահպանում է session ID-ն, որպեսզի հաջորդ հրամանները շարունակեն այն SID-ով՝ առանց վերաավարձման։

Հրամանների ուղեցույց

Հայտնաբերում և կենսական ցիկլ

Բրաուզերի ղեկավարում

Հոսթի հետ չատ

Ընդլայնված

Արդյունք և սխալներ

Հաջող հրամանները գրում են մեկ JSON տող stdout-ի։ Սխալները գնում են stderr՝ որպես JSON՝ "error" և "code" դաշտերով։ Փոխանցեք stdout-ը jq-ին՝ սցենարներում հրամանները շղթայելու համար։

Ելքի կոդեր

REST API

Ուղիղ HTTP հասանելիություն ցանկացած լեզվի կամ պլատֆորմի համար։

Վարձել սեսիա

POST /api/sessions/rent
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "geo": "DE",
  "duration": 300,
  "budget": 0.50
}

Պատասխան

{
  "session_id": "sess_abc123",
  "ws_url": "wss://browser.ceki.me/ws/sess_abc123",
  "host_geo": "DE",
  "rate_per_min": 0.05,
  "expires_at": "2026-04-30T15:05:00Z"
}

Endpoint-ներ

MCP պրոտոկոլ

Ceki-ն բնականորեն աջակցում է Model Context Protocol-ին — բաց ստանդարտ AI ագենտներին արտաքին գործիքների հետ կապելու համար։ Աշխատում է Claude-ի, GPT-ի, LangChain-ի և ցանկացած MCP-համատեղելի ագենտի հետ։

Կոնֆիգուրացիա

Ավելացրեք Ceki-ն ձեր ագենտի MCP կոնֆիգում (նույնը, ինչ Արագ սկզբում)՝

{
  "mcpServers": {
    "ceki": {
      "url": "https://api.ceki.me/mcp/agent",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Հասանելի գործիքներ

Ագենտի երկխոսության օրինակ

User: "Rent a browser in Germany and check the price on example.com"

Agent: [calls rent_browser(geo="DE", duration=60)]
  -> Session sess_abc123 ready

Agent: [calls navigate(url="https://example.com")]
  -> Page loaded, title: "Example Domain"

Agent: [calls extract(selector=".price")]
  -> Extracted: "$29.99"

Agent: [calls close()]
  -> Session ended

Agent: "The price on example.com is $29.99 (checked from a German IP)."

Նույնականացում

Բոլոր API հարցումները պահանջում են Bearer token Authorization header-ում։

Authorization: Bearer YOUR_API_KEY

Ձեր API բանալին ստանալը

Տարբերակ 1 (MCP)՝ Կանչեք հանրային register-agent MCP գործիքը — տես Արագ սկիզբ ամբողջական ընթացակարգի համար։

Տարբերակ 2 (Dashboard)՝ Գրանցվեք ceki.me-ում, ապա անցեք Dashboard → Agents → Create Agent։ api_key-ն ցուցադրվում է մեկ անգամ — անմիջապես պատճենեք այն։

Webhook-ներ

Ստացեք իրական ժամանակում ծանուցումներ սեսիայի իրադարձությունների մասին՝ HTTP webhook-ների միջոցով։

Իրադարձություններ

Payload-ի օրինակ

{
  "event": "session.ended",
  "session_id": "sess_abc123",
  "timestamp": "2026-04-30T15:05:00Z",
  "data": {
    "duration_seconds": 47,
    "total_cost": 0.24,
    "host_geo": "DE",
    "pages_visited": 3
  }
}