Tomba MCP

Tomba.io MCP Sunucusu

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

Özellikler

Araçlar (28 mevcut)

E-posta Bulma

• Domain Arama: Bir alan adıyla ilişkili tüm e-posta adreslerini bulun
• E-posta Bulucu: İsimlerden ve alan adlarından olası e-posta adresleri oluşturun
• Yazar Bulucu: Makale yazarlarının e-posta adreslerini keşfedin
• LinkedIn Bulucu: LinkedIn profil URL'lerinden e-postalar bulun
• E-posta Sayısı: Alan adları için toplam e-posta sayılarını alın
• E-posta Kaynakları: Bir e-posta adresinin web'de nerede bulunduğunu keşfedin
• E-posta Formatı: Bir alan adı tarafından kullanılan e-posta formatı desenlerini alın

Doğrulama

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

Zenginleştirme

• E-posta Zenginleştirme: E-postaları ek iletişim verileriyle zenginleştirin
• Kişi Zenginleştirme: E-posta ile kişi verilerini bulun (isim, pozisyon, sosyal profiller)
• Şirket Zenginleştirme: Alan adı ile şirket verilerini bulun (sektör, boyut, konum)
• Birleşik Zenginleştirme: E-posta ile birleşik kişi + şirket 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 geçici olup olmadığını kontrol edin
• Otomatik Tamamlama: Logo ve alan adı bilgisiyle şirket adı önerileri
• Benzer Bulucu: Hedef 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)
• Potansiyel Müşterileri Listele: İsteğe bağlı alan adı filtresiyle potansiyel müşterileri listeleyin
• Potansiyel Müşteri Oluştur: Bir listeye yeni potansiyel müşteri 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 kişilerini ve yapısını araştırın
• enrich_lead - Bir potansiyel müşteriyi mevcut tüm verilerle zenginleştirin
• find_journalists - Makalelerden gazeteci kişilerini bulun
• phone_finder - Kişiler 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 kişilerini bularak potansiyel müşteriler oluşturun
• prospect_enrichment - Şirket potansiyel müşterilerini kapsamlı verilerle zenginleştirin
• industry_analysis - Bir sektördeki şirketleri ayrıntılı segmentasyonla analiz edin

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

Filtre	Mevcut Değerler
Boyut	1-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ür	education, government, nonprofit, private, public, personal
Gelir	$0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
Sektör	LinkedIn 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 catch-all 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 ve plan başına uygulanır:

Plan	Saniyede	Dakikada	Günde
Ücretsiz	1	2	5
Temel	3	50	500
Büyüme	5	80	1.000
Pro	8	150	4.000
50.000+ planlar	Sınırsız	Sınırsız	Sınırsız

Tomba bir sonuç sağlayamadığında kredi ücretlendirilmez. 30 gün içindeki yinelenen istekler tekrar 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

• Node.js 18 veya üzeri
• npm veya yarn
• Tomba API hesabı (Buradan kaydolun)

Ekran Görüntüleri

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 artık skills/tomba-contact-intelligence/SKILL.md konumunda çalışma alanına özel bir OpenClaw becerisi içermektedir.

Beceri, OpenClaw'ın kişi 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ı olmak üzere tasarlanmıştır.

Kullanmak için:

1. Bu depoyu OpenClaw çalışma alanınız olarak açın veya skills/tomba-contact-intelligence dizinini OpenClaw becerileri 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 istemler:

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

Claude Desktop Kurulumu

Bu sunucuyu Claude Desktop ile kullanmak için claude_desktop_config.json dosyanıza yapılandırmayı 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 yoluyla değiştirin
• Yapılandırmayı güncelledikten sonra Claude Desktop'u yeniden başlatın

Tomba API Kimlik Bilgilerini Alma

1. https://tomba.io adresini ziyaret edin
2. Bir hesap için kaydolun veya giriş yapı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 kurulumla 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ı Olayları (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:

• 📋 Mevcut tüm 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. Domain 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 adresleri 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 dayalı telefon numaraları 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ını 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
    }
}

Mevcut 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ı bilgilerini 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 durumu ile 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 panelinizi kontrol edin
2. Geri Çekilmeyi Uygulayın: 429 yanıtlarını üstel geri çekilme ile ele alın
3. Toplu İşlemler: Aynı alan adından birden fazla e-posta için alan adı aramasını 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 adı 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 biçimleri 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

Sunucu Claude Desktop'ta Başlamıyor

1. Node.js sürümünü kontrol edin: Node.js 18 veya üzeri sürüme sahip olduğunuzdan emin olun

   node --version
   

2. NPX Kullanarak:

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

3. Yerel Kurulum Kullanarak:

   • 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, doğru ve derinlemesine e-posta adresi veri kaynağı olmakla gurur duyar. E-posta bulucu API'mizi üretmek için terabaytlarca veriyi işliyoruz.

Katkıda Bulunma

1. Fork'layı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 Lisans dosyasına bakın.

Destek

• GitHub Sorunları
• E-posta Desteği
• Web Sitesi