Tomba MCP

resmi

Tomba, benzersiz B2B e-posta bulucunuz ve doğrulayıcınız, zahmetsiz ve etkili erişim ölçeklendirmesi için farklı bir potansiyel müşteri veritabanı sağlar.

GitHub
8

Tomba MCP ile neler yapabilirsiniz?

  • İletişim e-postalarını bulun — domain_search ile bir alan adına bağlı tüm e-posta adreslerini, departman veya ülke gibi filtrelerle isteyin.
  • Olası adresler oluşturun — email_finder kullanarak bir kişinin adı ve şirket alan adından olası e-postaları oluşturun.
  • Teslim edilebilirliği doğrulayın — email_verifier ile SMTP ve MX kontrolleri dahil bir e-postanın geçerli ve teslim edilebilir olup olmadığını kontrol edin.
  • İletişim verilerini zenginleştirin — email_enrichment ile bilinen bir e-posta için ayrıntılı profiller (ad, pozisyon, sosyal medya) çekin.
  • Yazar e-postalarını keşfedin — author_finder ile bir URL'den makale yazarının e-postasını çıkarın.

Dokümantasyon

Tomba Tomba.io MCP Sunucusu

Tomba.io API ile entegrasyon için bir Model Context Protocol (MCP) sunucusu. Bu sunucu, standart bir MCP arayüzü üzerinden kapsamlı e-posta bulma, doğrulama ve zenginleştirme yetenekleri sağlar.

Özellikler

Araçlar (28 mevcut)

E-posta Bulma

Doğrulama

  • E-posta Doğrulayıcı: E-posta teslim edilebilirliğini doğrulayın ve veritabanı varlığını kontrol edin

Zenginleştirme

Telefon

  • Telefon Bulucu: E-posta, alan adı veya LinkedIn ile telefon numaraları arayın
  • Telefon Doğrulayıcı: Telefon numaralarını doğrulayın ve operatör bilgilerini kontrol edin

Alan Adı İstihbaratı

  • Alan Adı Durumu: Bir alan adının webmail veya tek kullanımlık olup olmadığını kontrol edin
  • Otomatik Tamamlama: Logo ve alan adı bilgisiyle şirket adı önerileri
  • Benzer Bulucu: Hedef bir alan adına dayalı benzer alan adlarını bulun
  • Teknoloji Bulucu: Web siteleri tarafından kullanılan teknoloji yığınlarını keşfedin
  • Konum: Ülkeye göre çalışan konumu sayısını alın

Şirket Arama

  • Şirket Arama: Gelişmiş filtrelerle doğal dil sorguları kullanarak şirketleri arayın

Hesap ve Yönetim

  • Hesap Bilgileri: Geçerli hesap bilgilerini, planı ve kredileri alın
  • Kullanım Bilgileri: Tüm uç noktalarda API kullanım istatistiklerini alın
  • Bayrakları Listele: Durum ve kredi iadeleriyle gönderilen veri bayraklarını listeleyin
  • Bayrak Oluştur: Kredi kurtarma için yanlış verileri bildirin (sert geri dönüşler, geçersiz e-postalar)
  • Müşteri Adaylarını Listele: İsteğe bağlı alan adı filtresiyle müşteri adaylarını listeleyin
  • Müşteri Adayı Oluştur: Bir listeye yeni bir müşteri adayı ekleyin
  • Anahtarları Listele: API anahtarlarını listeleyin
  • Günlükleri Al: Son API istek günlüklerini alın

Kaynaklar (7 mevcut)

  • tomba://api/status - API durumu ve hesap bilgileri
  • tomba://domain/{domain} - Alan adı bilgileri
  • tomba://email/{email} - E-posta bilgileri
  • tomba://similar/{domain} - Benzer alan adları analizi
  • tomba://technology/{domain} - Teknoloji yığını bilgileri
  • tomba://docs/api - API dokümantasyonu
  • tomba://docs/tools - Araç dokümantasyonu

İstemler (16 önceden oluşturulmuş iş akışı)

  • find_contact - Bir kişi için eksiksiz iletişim bilgilerini bulun
  • verify_email_list - E-posta adreslerini toplu doğrulayın
  • research_company - Şirket iletişimlerini ve yapısını araştırın
  • enrich_lead - Bir müşteri adayını mevcut tüm verilerle zenginleştirin
  • find_journalists - Makalelerden gazeteci iletişimlerini bulun
  • phone_finder - İletişimler için telefon numaraları bulun
  • validate_phone - Bir telefon numarasını doğrulayın
  • competitor_analysis - Benzer alan adları ve teknoloji kullanarak rakipleri analiz edin
  • technology_audit - Bir web sitesinin kapsamlı teknoloji denetimi
  • domain_insights - E-posta sayısı ve teknoloji dahil bir alan adı hakkında kapsamlı bilgiler alın
  • bulk_domain_research - E-posta sayıları ve temel bilgiler için birden fazla alan adını araştırın
  • find_target_companies - Gelişmiş filtrelerle şirketleri bulun (boyut, tür, gelir, sektör)
  • market_research - Kapsamlı filtreleme ile bir pazar segmentindeki şirketleri araştırın
  • lead_generation - Şirketleri ve iletişimlerini bularak müşteri adayları oluşturun
  • prospect_enrichment - Şirket potansiyel müşterilerini kapsamlı verilerle zenginleştirin
  • industry_analysis - Detaylı segmentasyon ile bir sektördeki şirketleri analiz edin

Şirket Arama İstemleri için Filtre Seçenekleri

FiltreMevcut Değerler
Boyut1-10 (Mikro), 11-50 (Küçük), 51-250 (Orta), 251-1K (Orta-büyük), 1K-5K (Büyük), 5K-10K (Çok büyük), 10K-50K (Kurumsal), 50K-100K (Devasa), 100K+ (Global)
Türeğitim, devlet, kar amacı gütmeyen, özel, halka açık, kişisel
Gelir$0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
SektörLinkedIn Sektör Kodları V2'ye dayalı (Bilgisayar Yazılımı, Finansal Hizmetler, Hastane ve Sağlık Hizmetleri vb. dahil 140+ sektör)

Performans ve Güvenilirlik

Zaman Aşımı

Tüm API çağrılarında 120 saniyelik zaman aşımı vardır. Tomba aramaları canlı altyapıya karşı gerçek zamanlı çalışır — yanıt süreleri hedef şirketin SMTP sunucu hızına, web sitesi yanıt verebilirliğine ve tümünü yakalama tespitinin derinliğine göre değişir.

Üstel Geri Çekilme ile Yeniden Deneme

Tüm API çağrıları aşağıdaki durumlarda üstel geri çekilme ile otomatik olarak 3 kez yeniden dener:

  • 429 Too Many Requests (oran sınırı aşıldı)
  • 5xx sunucu hataları

Yeniden deneme gecikmeleri: 1s → 2s → 4s.

Oran Sınırları

Oran sınırları uç nokta başına ve plan başına uygulanır:

PlanSaniyedeDakikadaGünde
Ücretsiz125
Temel350500
Büyüme5801.000
Pro81504.000
50.000+ planlarSınırsızSınırsızSınırsız

Tomba bir sonuç sağlayamadığında kredi ücretlendirilmez. 30 gün içindeki tekrarlanan istekler yeniden sayılmaz.

Taşıma Seçenekleri

  • stdio - Standart giriş/çıkış (varsayılan, Claude Desktop için)
  • http - REST uç noktalarına sahip HTTP sunucusu

Kurulum

Ön Koşullar

Ekran Görüntüleri

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4 Screenshot 5

Not: npm paketi tomba-mcp-server'dan @tomba-io/tomba-mcp-server'a yeniden adlandırıldı. Lütfen yapılandırmalarınızı buna göre güncelleyin.

Seçenek 1: NPX ile Kurulum (Önerilen)

Tomba MCP sunucusunu kullanmanın en kolay yolu, depoyu klonlamayı gerektirmeyen npx aracılığıyladır:

macOS/Linux

claude_desktop_config.json dosyanıza (~/Library/Application Support/Claude/claude_desktop_config.json) ekleyin:

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": ["-y", "@tomba-io/tomba-mcp-server"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Windows

claude_desktop_config.json dosyanıza (%APPDATA%\Claude\claude_desktop_config.json) ekleyin:

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": ["-y", "@tomba-io/tomba-mcp-server"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Not: -y bayrağı kurulum istemini otomatik olarak kabul eder ve npx her zaman en son sürümü getirir.

Seçenek 2: Kaynaktan Kurulum

Sunucuyu değiştirmek veya geliştirmeye katkıda bulunmak istiyorsanız:

# Clone the repository
git clone https://github.com/tomba-io/tomba-mcp-server.git
cd tomba-mcp-server

# Install dependencies
yarn install

# Build the project
yarn build

Yapılandırma

OpenClaw Becerisi

Bu depo, skills/ içinde çalışma alanına özgü beceriler içerir. Cursor eklentisi (.cursor-plugin/plugin.json) bunları da yükler.

skills/tomba-contact-intelligence/SKILL.md ana beceridir. Aracının iletişim bulma, şirket araştırması, e-posta doğrulama, telefon arama ve potansiyel müşteri zenginleştirme iş akışları için doğru Tomba MCP araçlarını seçmesine yardımcı olur.

Her MCP aracının ayrıca kendi beceri klasörü vardır, skills/tomba-<tool-name>/SKILL.md. Her biri aracın girdilerini, iş akışını, beklenen çıktısını ve örnek bir çağrıyı kapsar:

GrupBeceriler
E-postatomba-email-finder, tomba-email-verifier, tomba-email-enrichment, tomba-email-count, tomba-email-sources, tomba-email-format
Keşiftomba-domain-search, tomba-author-finder, tomba-linkedin-finder
Telefontomba-phone-finder, tomba-phone-validator
Şirkettomba-companies-search, tomba-company-enrichment, tomba-similar-finder, tomba-technology-finder, tomba-autocomplete, tomba-location, tomba-domain-status
Zenginleştirmetomba-person-enrichment, tomba-combined-enrichment
Potansiyel Müşteritomba-list-leads, tomba-create-lead
Veri kalitesitomba-list-flags, tomba-create-flag
Hesaptomba-account-info, tomba-usage-info, tomba-list-keys, tomba-get-logs

Kullanmak için:

  1. Bu depoyu OpenClaw çalışma alanınız olarak açın veya ihtiyacınız olan skills/tomba-* dizinlerini OpenClaw beceriler dizininize kopyalayın.
  2. Tomba MCP sunucusunun yapılandırıldığından ve OpenClaw için kullanılabilir olduğundan emin olun.
  3. Becerinin yüklenmesi için yeni bir OpenClaw oturumu başlatın.

Örnek komutlar:

  • "stripe.com için ortaklık alanında en iyi kişiyi bul ve e-postayı geri dönmeden önce doğrula."
  • "Almanya'daki fintech şirketlerini araştır, ardından en iyi eşleşmeler için olası satış kişilerini belirle."
  • "Bu potansiyel müşteriyi e-posta, telefon, şirket teknolojisi ve benzer rakiplerle zenginleştir: jane@acme.com"

Claude Code Eklentisi

Bu depo aynı zamanda bir Claude Code eklenti pazarıdır (.claude-plugin/). Eklenti, skills/ içindeki her beceriyi paketler ve https://mcp.tomba.io/mcp adresindeki barındırılan MCP sunucusuna bağlanır:

/plugin marketplace add tomba-io/tomba-mcp-server
/plugin install tomba@tomba

Ardından /mcp komutunu çalıştırın ve tomba sunucusunu OAuth ile doğrulayın. API anahtarları gerekmez. Eklenti becerileri ad alanlarına ayrılmıştır, örneğin /tomba:tomba-domain-search zapier.com.

Codex Eklentisi

.codex-plugin/plugin.json, aynı becerileri OpenAI Codex için paketler. Uzak sunucuyu .mcp.json adresinden yükler. Eklentiyi kurduktan sonra OAuth ile oturum açın:

codex mcp login tomba

OAuth yerine API anahtarları kullanmak için X-Tomba-Key ve X-Tomba-Secret başlıklarını veya Authorization: Bearer <base64(ta_key:ts_secret)> değerini https://mcp.tomba.io/mcp adresine gönderin.

Claude Desktop Kurulumu

Bu sunucuyu Claude Desktop ile kullanmak için yapılandırmayı claude_desktop_config.json dosyanıza ekleyin.

NPX Kullanarak (Önerilen)

Bu yöntem otomatik olarak en son yayınlanan sürümü kullanır:

macOS/Linux (~/Library/Application Support/Claude/claude_desktop_config.json):

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": ["-y", "@tomba-io/tomba-mcp-server"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Windows (%APPDATA%\Claude\claude_desktop_config.json):

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": ["-y", "@tomba-io/tomba-mcp-server"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Yerel Kurulum Kullanarak

Kaynaktan derlediyseniz, kurulumunuzun mutlak yolunu kullanın:

macOS/Linux:

{
    "mcpServers": {
        "tomba": {
            "command": "node",
            "args": ["/ABSOLUTE/PATH/TO/tomba-mcp-server/server/index.js"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Windows:

{
    "mcpServers": {
        "tomba": {
            "command": "node",
            "args": [
                "C:\\ABSOLUTE\\PATH\\TO\\tomba-mcp-server\\server\\index.js"
            ],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Önemli Notlar:

  • your-api-key-here ve your-secret-key-here değerlerini gerçek Tomba API kimlik bilgilerinizle değiştirin
  • Yerel kurulum için /ABSOLUTE/PATH/TO/tomba-mcp-server değerini kurulum dizininizin tam yolu ile değiştirin
  • Yapılandırmayı güncelledikten sonra Claude Desktop'ı yeniden başlatın

Tomba API Kimlik Bilgileri Alma

  1. https://tomba.io adresini ziyaret edin
  2. Bir hesap oluşturun veya oturum açın
  3. Panonuza gidin
  4. API ayarlarına gidin
  5. API Anahtarınızı ve Gizli Anahtarınızı kopyalayın

Alternatif: HTTP Taşıma Kullanma

npx ile HTTP taşıma için:

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": [
                "-y",
                "@tomba-io/tomba-mcp-server",
                "--transport",
                "http",
                "--port",
                "3000"
            ],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Yerel kurulum ile HTTP taşıma için:

{
    "mcpServers": {
        "tomba": {
            "command": "node",
            "args": [
                "/ABSOLUTE/PATH/TO/tomba-mcp-server/server/index.js",
                "--transport",
                "http",
                "--port",
                "3000"
            ],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Kullanım

Komut Satırı Seçenekleri

Usage: tomba-mcp-server [options]

Options:
  --transport <type>    Transport type: 'stdio' or 'http' (default: stdio)
  --port <number>       Port number for HTTP transport (default: 3000)
  --help                Show help message

Environment Variables:
  TOMBA_API_KEY         Your Tomba API key (required)
  TOMBA_SECRET_KEY      Your Tomba secret key (required)

Examples:
  # Run with stdio transport (default)
  node server/index.js

  # Run with HTTP transport on default port (3000)
  node server/index.js --transport http

  # Run with HTTP transport on custom port
  node server/index.js --transport http --port 8080

Bağımsız HTTP Sunucusu

Sunucuyu bağımsız bir HTTP hizmeti olarak da çalıştırabilirsiniz:

export TOMBA_API_KEY="your-api-key"
export TOMBA_SECRET_KEY="your-secret-key"
node server/index.js --transport http --port 3000

HTTP API Uç Noktaları

  • POST /mcp - JSON-RPC istekleri gönderin
  • GET /mcp - Bildirimler için Sunucu Tarafından Gönderilen Etkinlikler (X-Session-Id başlığı gerektirir)
  • DELETE /mcp - Bir oturumu sonlandırın (X-Session-Id başlığı gerektirir)
  • GET /health - Sağlık kontrolü uç noktası
  • GET /sessions - Etkin oturumları listeleyin (kimlik doğrulama gerektirir)

Örnek HTTP İsteği

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "email_finder",
      "arguments": {
        "domain": "stripe.com",
        "firstName": "Patrick",
        "lastName": "Collison"
      }
    },
    "id": 1
  }'

🔧 Geliştirme

Geliştirme Komutları

# Run in development mode
yarn dev

# Build the project
yarn build

# Run tests
yarn test

# Run tests in watch mode
yarn test:watch

# Run tests with coverage
yarn test:coverage

# Lint code
yarn lint

# Fix linting errors
yarn lint:fix

🔍 Hata Ayıklama ve Test

MCP Inspector (Önerilen)

MCP sunucunuzu test etmenin ve hata ayıklamanın en kolay yolu:

# Build and launch MCP Inspector
yarn debug

Bu, aşağıdakileri yapabileceğiniz bir web arayüzü açar:

  • 📋 Tüm kullanılabilir araçları görüntüleyin
  • 🧪 Araçları etkileşimli olarak test edin
  • 📊 İstekleri/yanıtları inceleyin
  • 🐛 Gerçek zamanlı hata ayıklayın

Alternatif Hata Ayıklama Yöntemleri

# Debug TypeScript directly
yarn debug:dev

# Run integration tests
yarn test:integration

# Manual testing
yarn build
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node server/index.js

VS Code Hata Ayıklama

VS Code kullanıyorsanız, dahil edilen hata ayıklama yapılandırmalarını kullanın:

  • MCP Sunucusunda Hata Ayıkla: Derlenmiş JavaScript'te hata ayıklayın
  • TypeScript'te Hata Ayıkla: TypeScript kaynağında doğrudan hata ayıklayın
  • Inspector ile Hata Ayıkla: MCP Inspector ile hata ayıklayın
  • Testleri Çalıştır: Jest testlerinde hata ayıklayın

Kapsamlı hata ayıklama talimatları için DEBUG_GUIDE.md bölümüne bakın.

🧪 Bireysel Araçları Test Etme

1. Alan Adı Arama

Bir alan adıyla ilişkili e-posta adreslerini arayın.

{
    "name": "domain_search",
    "arguments": {
        "domain": "tomba.io",
        "limit": 10,
        "page": 1
    }
}

Yanıt:

{
  "data": {
    "organization": {
      "website_url": "tomba.io",
      "organization": "Tomba technology web service LLC",
      "location": {
        "country": "US",
        "city": "Claymont",
        "state": "Delaware",
        "street_address": "1228 claymont",
        "postal_code": "19703"
      },
      "social_links": {
        "twitter_url": "https://twitter.com/tombaplatforum",
        "facebook_url": "https://www.facebook.com/tombaplatforum",
        "linkedin_url": "https://www.linkedin.com/company/tomba-io"
      },
      "disposable": false,
      "webmail": false,
      "phone_number": "(850) 790-5575",
      "industries": "Information Technology and Services",
      "founded": "2021",
      "company_size": "1-10",
      "company_type": "privately held",
      "revenue": "$0-$1M",
      "accept_all": false,
      "description": "the most powerful email-finding tool which is able to list all the email addresses of people who are working in a particular company.",
      "pattern": "{l}.{first}",
      "total_similar": 35,
      "keywords": [
        "lead generation software"
      ],
      "ranking": 661495,
      "whois": {
        "registrar_name": "namecheap, inc.",
        "created_date": "2020-07-07T20:54:07+02:00",
        "referral_url": "https://www.namecheap.com/"
      },
      "last_updated": "2025-09-06T00:22:01+02:00"
    },
    "emails": [
      {
        "email": "b.mohamed@tomba.io",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "gender": "male",
        "phone_number": false,
        "type": "personal",
        "country": "DZ",
        "position": "CEO",
        "department": "executive",
        "seniority": "senior",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "verification": {
          "date": "2025-09-22T00:00:00+02:00",
          "status": "valid"
        },
        "sources": [
          {
            "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
            "website_url": "github.com",
            "extracted_on": "2021-02-08T20:09:54+01:00",
            "last_seen_on": "2021-02-08T22:43:40+01:00",
            "still_on_page": true
          },
          ....
        ]
      },
      ...
      ...
      ...
      ...
      ...
    ]
  },
  "meta": {
    "total": 21,
    "pageSize": 10,
    "current": 1,
    "total_pages": 3,
    "params": {
      "domain": "tomba.io",
      "page": 1,
      "limit": 10,
      "department": null,
      "country": null,
      "type": "all",
      "live": false
    }
  }
}

2. E-posta Bulucu

Alan adı, ad ve soyaddan olası e-posta adresleri oluşturun.

{
    "name": "email_finder",
    "arguments": {
        "domain": "example.com",
        "firstName": "John",
        "lastName": "Doe"
    }
}

Yanıt:

{
    "data": {
        "email": "b.mohamed@tomba.io",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "website_url": "tomba.io",
        "company": "Tomba technology web service LLC",
        "position": "CEO",
        "country": "DZ",
        "gender": "male",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "accept_all": null,
        "phone_number": false,
        "verification": {
            "date": "2025-09-22T00:00:00+02:00",
            "status": "valid"
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

3. E-posta Doğrulayıcı

E-posta adresinin teslim edilebilirliğini doğrulayın ve veritabanı varlığını kontrol edin.

{
    "name": "email_verifier",
    "arguments": {
        "email": "b.mohamed@tomba.io"
    }
}

Yanıt:

{
    "data": {
        "email": {
            "email": "b.mohamed@tomba.io",
            "result": "deliverable",
            "status": "valid",
            "score": 99,
            "smtp_provider": "Google Workspace",
            "mx": {
                "records": [
                    "aspmx.l.google.com",
                    "alt2.aspmx.l.google.com",
                    "alt1.aspmx.l.google.com",
                    "alt4.aspmx.l.google.com",
                    "alt3.aspmx.l.google.com"
                ]
            },
            "mx_check": true,
            "smtp_server": true,
            "smtp_check": true,
            "accept_all": false,
            "greylisted": false,
            "block": true,
            "gibberish": false,
            "disposable": false,
            "webmail": false,
            "regex": true,
            "whois": {
                "registrar_name": "namecheap, inc.",
                "referral_url": "https://www.namecheap.com/",
                "created_date": "2020-07-07T20:54:07+02:00"
            }
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

4. E-posta Zenginleştirme

Bir e-posta adresini ek iletişim bilgileriyle zenginleştirin.

{
    "name": "email_enrichment",
    "arguments": {
        "email": "b.mohamed@tomba.io"
    }
}

Yanıt:

{
    "data": {
        "email": "b.mohamed@tomba.io",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "website_url": "tomba.io",
        "company": "Tomba technology web service LLC",
        "position": "CEO",
        "country": "DZ",
        "gender": "male",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "accept_all": null,
        "phone_number": false,
        "verification": {
            "date": "2025-09-22T00:00:00+02:00",
            "status": "valid"
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

5. Yazar Bulucu

Bir URL'den makale yazarlarının e-posta adreslerini bulun.

{
    "name": "author_finder",
    "arguments": {
        "url": "https://example.com/article"
    }
}

Yanıt:

{
    "data": {
        "email": "b.mohamed@tomba.io",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "website_url": "tomba.io",
        "company": "Tomba technology web service LLC",
        "position": "CEO",
        "country": "DZ",
        "gender": "male",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "accept_all": null,
        "phone_number": false,
        "verification": {
            "date": "2025-09-22T00:00:00+02:00",
            "status": "valid"
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

6. LinkedIn Bulucu

LinkedIn profil URL'lerinden e-posta adreslerini bulun.

{
    "name": "linkedin_finder",
    "arguments": {
        "url": "https://linkedin.com/in/johndoe"
    }
}

Yanıt:

{
    "data": {
        "email": "b.mohamed@tomba.io",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "website_url": "tomba.io",
        "company": "Tomba technology web service LLC",
        "position": "CEO",
        "country": "DZ",
        "gender": "male",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "accept_all": null,
        "phone_number": false,
        "verification": {
            "date": "2025-09-22T00:00:00+02:00",
            "status": "valid"
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

7. Telefon Bulucu

E-posta, alan adı veya LinkedIn profiline göre telefon numaralarını arayın.

{
    "name": "phone_finder",
    "arguments": {
        "domain": "tomba.io"
    }
}

Yanıt:

{
    "data": {
        "domain": "tomba.io",
        "valid": true,
        "local_format": "(850) 790-5575",
        "intl_format": "+1 850-790-5575",
        "e164_format": "+18507905575",
        "rfc3966_format": "tel:+1-850-790-5575",
        "country_code": "US",
        "line_type": "FIXED_LINE_OR_MOBILE",
        "carrier": "",
        "timezones": ["America/New_York"]
    }
}

8. Telefon Doğrulayıcı

Telefon numaralarını doğrulayın ve operatör bilgilerini kontrol edin.

{
    "name": "phone_validator",
    "arguments": {
        "phone": "+213667945402"
    }
}

Yanıt:

{
    "data": {
        "valid": true,
        "local_format": "0667 94 54 02",
        "intl_format": "+213 667 94 54 02",
        "e164_format": "+213667945402",
        "rfc3966_format": "tel:+213-667-94-54-02",
        "country_code": "DZ",
        "line_type": "MOBILE",
        "carrier": "Mobilis",
        "timezones": ["Europe/Paris"]
    }
}

9. E-posta Sayısı

Bir alan adı için toplam e-posta adresi sayısını alın.

{
    "name": "email_count",
    "arguments": {
        "domain": "tomba.io"
    }
}

Yanıt:

{
    "domain": "tomba.io",
    "total": 245,
    "personalEmails": 198,
    "genericEmails": 47,
    "department": {
        "engineering": 45,
        "sales": 38,
        "marketing": 32,
        "hr": 15,
        "finance": 12,
        "legal": 8,
        "executive": 25,
        "support": 28,
        "other": 42
    },
    "seniority": {
        "junior": 89,
        "senior": 125,
        "executive": 31
    },
    "source": "tomba_email_count"
}

10. Benzer Bulucu

Belirli bir alan adına dayalı olarak benzer alan adlarını bulun.

{
    "name": "similar_finder",
    "arguments": {
        "domain": "tomba.io"
    }
}

Yanıt:

{
    "data": [
        {
            "website_url": "summit.com",
            "name": "Summit",
            "industries": "Wholesale"
        },
        {
            "website_url": "hunter.io",
            "name": "Hunter",
            "industries": "Information Technology and Services"
        },
        {
            "website_url": "voilaNorbert.com",
            "name": "VoilaNorbert",
            "industries": "Information Technology and Services"
        }
    ]
}

11. Teknoloji Bulucu

Herhangi bir web sitesinin teknoloji yığınını anında ortaya çıkarın.

{
    "name": "technology_finder",
    "arguments": {
        "domain": "tomba.io"
    }
}

Yanıt:

{
    "domain": "tomba.io",
    "data": [
        {
            "slug": "intercom",
            "name": "Intercom",
            "icon": "Intercom.png",
            "website": "https://www.intercom.com",
            "categories": {
                "id": 10,
                "slug": "analytics",
                "name": "Analytics"
            }
        }
    ]
}

12. Şirket Arama

Konum, sektör, boyut ve gelir dahil gelişmiş filtrelerle doğal dil sorguları kullanarak şirketleri arayın.

{
    "name": "companies_search",
    "arguments": {
        "filters": {
            "location_city": {
                "include": ["san francisco"]
            },
            "industry": {
                "include": ["technology"]
            },
            "size": {
                "include": ["51-200", "201-500"]
            }
        },
        "page": 1,
        "limit": 10
    }
}

Yanıt:

{
    "data": {
        "companies": [
            {
                "name": "Tech Company Inc",
                "domain": "techcompany.com",
                "industry": "Technology",
                "location": {
                    "city": "San Francisco",
                    "state": "California",
                    "country": "United States"
                },
                "size": "51-200",
                "revenue": "$10M-$50M"
            }
        ],
        "total": 150,
        "page": 1
    }
}

Kullanılabilir Filtreler:

  • location_city: Dahil etme/hariç tutma dizileriyle şehre göre filtrele
  • location_state: Dahil etme/hariç tutma dizileriyle eyalete göre filtrele
  • location_country: Dahil etme/hariç tutma dizileriyle ülkeye göre filtrele
  • industry: Sektöre göre filtrele (LinkedIn Sektör Kodları V2 - 140+ sektör)
  • type: Şirket türüne göre filtrele: education, government, nonprofit, private, public, personal
  • size: Şirket boyutuna göre filtrele: 1-10, 11-50, 51-250, 251-1K, 1K-5K, 5K-10K, 10K-50K, 50K-100K, 100K+
  • revenue: Gelir aralığına göre filtrele: $0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
  • founded: Dahil etme/hariç tutma dizileriyle kuruluş yılına göre filtrele
  • keywords: Dahil etme/hariç tutma dizileriyle anahtar kelimelere göre filtrele
  • sic: Dahil etme/hariç tutma dizileriyle SIC kodlarına göre filtrele
  • naics: Dahil etme/hariç tutma dizileriyle NAICS kodlarına göre filtrele
  • similar: Dahil etme/hariç tutma dizileriyle benzer alan adlarına göre filtrele

Hız Sınırlama ve Kullanım

API Hız Sınırları

Tomba.io, abonelik planınıza göre hız sınırlaması uygular:

  • Ücretsiz Plan: Ayda 50 istek
  • Büyüme Planı: Ayda 5.000 istek + 10.000 doğrulama isteği
  • Pro Plan: Ayda 10.000 istek
  • Kurumsal Plan: Ayda 50.000 istek
  • Özel Plan: Özel limitler

Tomba Fiyatlandırma Planları hakkında daha fazla bilgi edinin.

Hız Sınırı Başlıkları

Her API yanıtı hız sınırı bilgisi içerir:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1609459200

Tomba API Hız Sınırları hakkında daha fazla bilgi edinin.

Hız Sınırlarını Yönetme

Hız sınırınızı aştığınızda, API 429 Too Many Requests durumuyla yanıt döndürür:

{
    "error": {
        "type": "rate_limit",
        "message": "Rate limit exceeded. Please try again in 60 seconds",
        "code": 429
    }
}

En İyi Uygulamalar

  1. Kullanımı İzleyin: tomba.io/dashboard adresindeki panonuzu kontrol edin
  2. Geri Çekme Uygulayın: 429 yanıtlarını üstel geri çekme ile ele alın
  3. Toplu İşlemler: Aynı alan adından birden fazla e-posta için alan adı araması kullanın
  4. Sonuçları Önbelleğe Alın: Tekrarlanan istekleri önlemek için sonuçları yerel olarak saklayın
  5. Buna Göre Planlayın: Kullanım kalıplarına göre planınızı yükseltin

Kullanım İpuçları

  • Alan araması, istek başına birden fazla e-posta döndürür (bireysel sorgulamalardan daha verimlidir)
  • E-posta doğrulama, yalnızca geçerli e-posta formatları için kredi tüketir
  • Telefon bulucu, istek başına birden fazla numara döndürebilir
  • Zenginleştirme, tek bir istekte kapsamlı veri sağlar

Sorun Giderme

Claude Desktop'ta Sunucu Başlatılamıyor

  1. Node.js sürümünü kontrol edin: Node.js 18 veya üzeri sürümünüzün olduğundan emin olun

    node --version

  2. NPX Kullanımı:

    • İlk çalıştırma için istikrarlı bir internet bağlantınızın olduğundan emin olun
    • -y bayrağı kurulumu otomatik olarak kabul etmelidir
    • NPX, paketi ilk kullanımdan sonra önbelleğe alır

  3. Yerel Kurulum Kullanımı:

    • Yapılandırmanızda mutlak yolun doğru olduğunu doğrulayın
    • server/index.js öğesinin mevcut olduğundan emin olun: ls -la server/index.js
    • yarn build komutunu başarıyla çalıştırdığınızdan emin olun

  4. API kimlik bilgilerini doğrulayın: Tomba API anahtarlarınızın doğru olduğundan emin olun

  5. Claude günlüklerini kontrol edin:

    • macOS: ~/Library/Logs/Claude/mcp*.log
    • Windows: %APPDATA%\Claude\logs\mcp*.log

NPX'e Özgü Sorunlar

"npx komutu bulunamadı":

  • npm'in kurulu olduğundan emin olun: npm --version
  • NPX, npm 5.2.0+ ile birlikte gelir, gerekirse güncelleyin: npm install -g npm

Paket bulunamadı:

  • Paketin yayınlandığını doğrulayın: npm view @tomba-io/tomba-mcp-server
  • npm önbelleğini temizlemeyi deneyin: npm cache clean --force

Paket her zaman indiriliyor:

  • Bu, -y bayrağıyla normal bir davranıştır
  • NPX, paketi ilk indirmeden sonra önbelleğe alır
  • Kalıcı bir kurulum için yerel kurulum yöntemini kullanın

Kimlik Doğrulama Hataları

  • API anahtarlarınızı https://app.tomba.io/dashboard adresinde doğrulayın
  • Ortam değişkenlerinin yapılandırmada doğru şekilde ayarlandığından emin olun
  • API aboneliğinizin aktif olduğunu kontrol edin

Araçlar Yanıt Vermiyor

  • Tomba API hız sınırlarınızı kontrol edin
  • Ağ bağlantısını doğrulayın
  • Hata mesajları için sunucu günlüklerini inceleyin

Tomba Hakkında

2020'de kurulan Tomba, her yerde bulunabilen en güvenilir, en doğru ve en kapsamlı e-posta adresi veri kaynağı olmaktan gurur duyar. E-posta bulucu API'mizi üretmek için terabaytlarca veriyi işliyoruz.

image

Katkıda Bulunma

  1. Çatallayın (https://github.com/tomba-io/tomba-mcp-server/fork)
  2. Özellik dalınızı oluşturun (git checkout -b my-new-feature)
  3. Değişikliklerinizi kaydedin (git commit -am 'Add some feature')
  4. Dala gönderin (git push origin my-new-feature)
  5. Yeni bir Pull Request oluşturun

Lisans

Daha fazla bilgi için lütfen Lisans dosyasına bakın.

Destek