Geliştirici & AI Ajan Dokümantasyonu

CLI, MCP Server & REST API

FirmaNex hem terminal CLI aracı hem de standart Model Context Protocol (MCP) sunucusu sunar. Ajanlar kendi başına taslak hazırlayabilir; ancak yayın ve resmi doğrulama yetkili kontrolündedir.

Yayın & Moderasyon Kuralı

AI ajanlarının oluşturduğu kayıtlar varsayılan olarak hemen yayınlanır ve UNVERIFIED rozetiyle görünür; her kayıt için gizli bir claimToken üretilir. Hatalı veya istenmeyen kayıtlar moderasyon panelinden kaldırılır. Resmi Domain Doğrulaması için DNS TXT, /.well-known/firmanex-verify.txt veya kurumsal alan adı e-postası kontrol edilir. Tüm dış URL taramalarında SSRF koruması aktiftir.

1. FirmaNex CLI Kullanımı

# 1. Web sitesinden çok dilli firma profili oluştur ve yayınla
npx firmanex register --website https://www.ornekfirma.com.tr --lang tr,en,ar

# 2. Sahiplik doğrulama (DNS TXT, well-known, email-domain veya claim-code)
npx firmanex verify ornek-firma --token clm-xxxx --method dns-txt

# 3. Rehberde arama yap (JSON çıktı AI ajanları içindir)
npx firmanex search "otomasyon" --city istanbul --verified --json

# 4. Firmaya B2B teklif talebi gönder
npx firmanex quote karaca-teknik-otomasyon --name "Ali Kaya" --email "ali@sirket.com.tr" --message "CNC fason teklifi rica ederiz."

2. MCP Server Kurulumu (Claude Code, Codex, Gemini CLI, Cursor)

Claude Code (tek komut)

# Claude Code — uzak HTTP MCP (kurulum gerektirmez)
claude mcp add --transport http firmanex https://ilanturkiye.web.app/api/mcp

# Claude Code — yerel stdio MCP
claude mcp add firmanex -- npx -y firmanex-mcp

Gemini CLI · Cursor · Claude Desktop (mcpServers)

{
  "mcpServers": {
    "firmanex": {
      "command": "npx",
      "args": ["-y", "firmanex-mcp"]
    }
  }
}

Codex (config.toml)

# ~/.codex/config.toml
[mcp_servers.firmanex]
command = "npx"
args = ["-y", "firmanex-mcp"]

Doğrudan HTTP JSON-RPC Endpoint (/api/mcp)

curl -X POST https://ilanturkiye.web.app/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "firma_search",
      "arguments": { "city": "istanbul", "verifiedOnly": true }
    }
  }'

MCP Araç Adı	İşlev
firma_search	Şehir, sektör, anahtar kelime ve doğrulamaya göre firma arar.
firma_get_profile	Slug ile tam firma profilini ve çoklu dil özetlerini getirir.
firma_extract_from_url	Web sitesini analiz eder, kayıt açmadan JSON taslak döndürür.
firma_create_draft	Firma kaydı oluşturur; varsayılan olarak hemen yayınlar (draftOnly ile taslak).
firma_verify_ownership	DNS TXT, .well-known veya e-posta domain doğrulaması yapar.
firma_update_profile	claimToken ile firma profilini günceller.
firma_request_quote	Yayınlanmış firmaya teklif talebi gönderir.
firma_delete_company	claimToken ile hatalı veya istenmeyen kaydı siler.

3. REST API & GEO Uç Noktaları

GET /api/companies?q=&city=&sector=&verified=true
POST /api/extract { website, languages }
POST /api/companies { website, autoExtract: true, ... }
POST /api/companies/:slug/verify { claimToken, method }
GET /llms.txt · /sitemap.xml · /api/companies/:slug?format=jsonld