Tomba MCP Server

resmi

Tomba, pencari dan pemverifikasi email B2B unik Anda, menyediakan basis data prospek yang khas untuk memperluas jangkauan secara mudah dan efektif.

GitHub
7

Dokumentasi

Tomba Server MCP Tomba.io

Server Model Context Protocol (MCP) untuk integrasi dengan API Tomba.io. Server ini menyediakan kemampuan penemuan email, verifikasi, dan pengayaan yang komprehensif melalui antarmuka MCP standar.

Fitur

Alat (12 tersedia)

Sumber Daya (7 tersedia)

  • tomba://api/status - Status API dan info akun
  • tomba://domain/{domain} - Informasi domain
  • tomba://email/{email} - Informasi email
  • tomba://similar/{domain} - Analisis domain serupa
  • tomba://technology/{domain} - Informasi tumpukan teknologi
  • tomba://docs/api - Dokumentasi API
  • tomba://docs/tools - Dokumentasi alat

Prompt (16 alur kerja bawaan)

  • find_contact - Temukan info kontak lengkap untuk seseorang
  • verify_email_list - Verifikasi batch alamat email
  • research_company - Riset kontak dan struktur perusahaan
  • enrich_lead - Perkaya prospek dengan semua data yang tersedia
  • find_journalists - Temukan kontak jurnalis dari artikel
  • finder_phone - Temukan nomor telepon untuk kontak
  • validate_phone - Validasi nomor telepon
  • competitor_analysis - Analisis pesaing menggunakan domain serupa dan teknologi
  • technology_audit - Audit teknologi komprehensif dari sebuah situs web
  • domain_insights - Dapatkan wawasan komprehensif tentang domain termasuk jumlah email dan teknologi
  • bulk_domain_research - Riset beberapa domain untuk jumlah email dan informasi dasar
  • find_target_companies - Temukan perusahaan dengan filter lanjutan (ukuran, tipe, pendapatan, industri)
  • market_research - Riset perusahaan di segmen pasar dengan penyaringan komprehensif
  • lead_generation - Hasilkan prospek dengan menemukan perusahaan dan kontak mereka
  • prospect_enrichment - Perkaya prospek perusahaan dengan data komprehensif
  • industry_analysis - Analisis perusahaan dalam suatu industri dengan segmentasi terperinci

Opsi Filter untuk Prompt Pencarian Perusahaan

FilterNilai yang Tersedia
Ukuran1-10 (Mikro), 11-50 (Kecil), 51-250 (Menengah), 251-1K (Menengah-besar), 1K-5K (Besar), 5K-10K (Sangat besar), 10K-50K (Enterprise), 50K-100K (Masif), 100K+ (Global)
Tipeeducation, government, nonprofit, private, public, personal
Pendapatan$0-$1Jt, $1Jt-$10Jt, $10Jt-$50Jt, $50Jt-$100Jt, $100Jt-$250Jt, $250Jt-$500Jt, $500Jt-$1M, $1M-$10M, $10M+
IndustriBerdasarkan Kode Industri LinkedIn V2 (140+ industri termasuk Perangkat Lunak Komputer, Layanan Keuangan, Rumah Sakit & Layanan Kesehatan, dll.)

Opsi Transport

  • stdio - Input/output standar (default, untuk Claude Desktop)
  • http - Server HTTP dengan endpoint REST

Instalasi

Prasyarat

  • Node.js 18 atau lebih tinggi
  • npm atau yarn
  • Akun API Tomba (Daftar di sini)

Tangkapan Layar

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4 Screenshot 5

Opsi 1: Instal melalui NPX (Direkomendasikan)

Cara termudah untuk menggunakan server MCP Tomba adalah melalui npx, yang tidak memerlukan kloning repositori:

macOS/Linux

Tambahkan ke claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json):

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

Windows

Tambahkan ke claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json):

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

Catatan: Flag -y secara otomatis menerima prompt instalasi, dan npx akan selalu mengambil versi terbaru.

Opsi 2: Instal dari Sumber

Jika Anda ingin memodifikasi server atau berkontribusi pada pengembangan:

# 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

Konfigurasi

Skill OpenClaw

Repositori ini sekarang menyertakan skill OpenClaw lokal ruang kerja di skills/tomba-contact-intelligence/SKILL.md.

Skill ini dirancang untuk membantu OpenClaw memilih alat MCP Tomba yang tepat untuk penemuan kontak, riset perusahaan, verifikasi email, pencarian telepon, dan alur kerja pengayaan prospek.

Untuk menggunakannya:

  1. Buka repositori ini sebagai ruang kerja OpenClaw Anda, atau salin direktori skills/tomba-contact-intelligence ke direktori skill OpenClaw Anda.
  2. Pastikan server MCP Tomba dikonfigurasi dan tersedia untuk OpenClaw.
  3. Mulai sesi OpenClaw baru agar skill dimuat.

Contoh prompt:

  • "Temukan kontak terbaik untuk kemitraan di stripe.com dan verifikasi emailnya sebelum Anda mengembalikannya."
  • "Riset perusahaan fintech di Jerman, lalu identifikasi kontak penjualan yang mungkin untuk kecocokan teratas."
  • "Perkaya prospek ini dengan email, telepon, teknologi perusahaan, dan pesaing serupa: [email protected]"

Pengaturan Claude Desktop

Untuk menggunakan server ini dengan Claude Desktop, tambahkan konfigurasi ke file claude_desktop_config.json Anda.

Menggunakan NPX (Direkomendasikan)

Metode ini secara otomatis menggunakan versi terbaru yang dipublikasikan:

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

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": ["-y", "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-mcp-server"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Menggunakan Instalasi Lokal

Jika Anda telah membangun dari sumber, gunakan path absolut ke instalasi Anda:

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"
            }
        }
    }
}

Catatan Penting:

  • Ganti your-api-key-here dan your-secret-key-here dengan kredensial API Tomba Anda yang sebenarnya
  • Untuk instalasi lokal, ganti /ABSOLUTE/PATH/TO/tomba-mcp-server dengan path lengkap ke direktori instalasi Anda
  • Mulai ulang Claude Desktop setelah memperbarui konfigurasi

Mendapatkan Kredensial API Tomba

  1. Kunjungi https://tomba.io
  2. Daftar akun atau masuk
  3. Arahkan ke dasbor Anda
  4. Buka pengaturan API
  5. Salin Kunci API dan Kunci Rahasia Anda

Alternatif: Menggunakan Transport HTTP

Untuk transport HTTP dengan npx:

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

Untuk transport HTTP dengan instalasi lokal:

{
    "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"
            }
        }
    }
}

Penggunaan

Opsi Baris Perintah

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

Server HTTP Mandiri

Anda juga dapat menjalankan server sebagai layanan HTTP mandiri:

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

Endpoint API HTTP

  • POST /mcp - Kirim permintaan JSON-RPC
  • GET /mcp - Server-Sent Events untuk notifikasi (memerlukan header X-Session-Id)
  • DELETE /mcp - Akhiri sesi (memerlukan header X-Session-Id)
  • GET /health - Endpoint pemeriksaan kesehatan
  • GET /sessions - Daftar sesi aktif (memerlukan autentikasi)

Contoh Permintaan HTTP

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
  }'

🔧 Pengembangan

Perintah Pengembangan

# 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

🔍 Debugging & Pengujian

MCP Inspector (Direkomendasikan)

Cara termudah untuk menguji dan men-debug server MCP Anda:

# Build and launch MCP Inspector
yarn debug

Ini membuka antarmuka web di mana Anda dapat:

  • 📋 Melihat semua alat yang tersedia
  • 🧪 Menguji alat secara interaktif
  • 📊 Memeriksa permintaan/respons
  • 🐛 Debug secara real-time

Metode Debug Alternatif

# 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

Debugging VS Code

Jika menggunakan VS Code, gunakan konfigurasi debug yang disertakan:

  • Debug MCP Server: Debug JavaScript yang dikompilasi
  • Debug TypeScript: Debug sumber TypeScript secara langsung
  • Debug with Inspector: Debug dengan MCP Inspector
  • Run Tests: Debug pengujian Jest

Lihat DEBUG_GUIDE.md untuk instruksi debugging yang komprehensif.

🧪 Menguji Alat Individual

1. Pencarian Domain

Cari alamat email yang terkait dengan nama domain.

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

Respons:

{
  "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": "[email protected]",
        "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. Pencari Email

Hasilkan kemungkinan alamat email dari domain, nama depan, dan nama belakang.

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

Respons:

{
    "data": {
        "email": "[email protected]",
        "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. Verifikator Email

Verifikasi keterkiriman alamat email dan periksa keberadaan di basis data.

{
    "name": "email_verifier",
    "arguments": {
        "email": "[email protected]"
    }
}

Respons:

{
    "data": {
        "email": {
            "email": "[email protected]",
            "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. Pengayaan Email

Perkaya alamat email dengan informasi kontak tambahan.

{
    "name": "email_enrichment",
    "arguments": {
        "email": "[email protected]"
    }
}

Respons:

{
    "data": {
        "email": "[email protected]",
        "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. Pencari Penulis

Temukan alamat email penulis artikel dari URL.

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

Respons:

{
    "data": {
        "email": "[email protected]",
        "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. Pencari LinkedIn

Temukan alamat email dari URL profil LinkedIn.

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

Respons:

{
    "data": {
        "email": "[email protected]",
        "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. Pencari Telepon

Cari nomor telepon berdasarkan email, domain, atau profil LinkedIn.

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

Respons:

{
    "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. Validator Telepon

Validasi nomor telepon dan periksa informasi operator.

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

Respons:

{
    "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. Jumlah Email

Dapatkan total jumlah alamat email untuk sebuah domain.

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

Respons:

{
    "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. Pencari Serupa

Temukan domain serupa berdasarkan domain tertentu.

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

Respons:

{
    "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. Pencari Teknologi

Ungkap tumpukan teknologi situs web mana pun secara instan.

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

Respons:

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

12. Pencarian Perusahaan

Cari perusahaan menggunakan kueri bahasa alami dengan filter lanjutan termasuk lokasi, industri, ukuran, dan pendapatan.

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

Respons:

{
    "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
    }
}

Filter yang Tersedia:

  • location_city: Filter berdasarkan kota dengan array include/exclude
  • location_state: Filter berdasarkan negara bagian dengan array include/exclude
  • location_country: Filter berdasarkan negara dengan array include/exclude
  • industry: Filter berdasarkan industri (berdasarkan Kode Industri LinkedIn V2 - 140+ industri)
  • type: Filter berdasarkan tipe perusahaan: education, government, nonprofit, private, public, personal
  • size: Filter berdasarkan ukuran perusahaan: 1-10, 11-50, 51-250, 251-1K, 1K-5K, 5K-10K, 10K-50K, 50K-100K, 100K+
  • revenue: Filter berdasarkan rentang pendapatan: $0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
  • founded: Filter berdasarkan tahun pendirian dengan array include/exclude
  • keywords: Filter berdasarkan kata kunci dengan array include/exclude
  • sic: Filter berdasarkan kode SIC dengan array include/exclude
  • naics: Filter berdasarkan kode NAICS dengan array include/exclude
  • similar: Filter berdasarkan domain serupa dengan array include/exclude

Pembatasan Laju & Penggunaan

Batas Laju API

Tomba.io menerapkan pembatasan laju berdasarkan paket langganan Anda:

  • Paket Gratis: 50 permintaan per bulan
  • Paket Growth: 5.000 permintaan per bulan + 10.000 permintaan verifikasi
  • Paket Pro: 10.000 permintaan per bulan
  • Paket Enterprise: 50.000 permintaan per bulan
  • Paket Kustom: Batas khusus

Pelajari lebih lanjut tentang Paket Harga Tomba.

Header Batas Laju

Setiap respons API menyertakan informasi batas laju:

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

Pelajari lebih lanjut tentang Batas Laju API Tomba.

Menangani Batas Laju

Saat Anda melampaui batas laju, API mengembalikan status 429 Too Many Requests dengan:

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

Praktik Terbaik

  1. Pantau Penggunaan: Periksa dasbor Anda di tomba.io/dashboard
  2. Terapkan Backoff: Tangani respons 429 dengan backoff eksponensial
  3. Operasi Batch: Gunakan pencarian domain untuk beberapa email dari domain yang sama
  4. Cache Hasil: Simpan hasil secara lokal untuk menghindari permintaan duplikat
  5. Rencanakan Sesuai: Tingkatkan paket Anda berdasarkan pola penggunaan

Tips Penggunaan

  • Pencarian domain mengembalikan beberapa email per permintaan (lebih efisien daripada pencarian individual)
  • Verifikasi email hanya mengonsumsi kredit untuk format email yang valid
  • Pencari telepon dapat mengembalikan beberapa nomor per permintaan
  • Pengayaan menyediakan data komprehensif dalam satu permintaan

Pemecahan Masalah

Server Tidak Mulai di Claude Desktop

  1. Periksa versi Node.js: Pastikan Anda memiliki Node.js 18 atau lebih tinggi

    node --version

  2. Menggunakan NPX:

    • Pastikan Anda memiliki koneksi internet yang stabil untuk menjalankan pertama kali
    • Flag -y seharusnya otomatis menerima instalasi
    • NPX akan menyimpan cache paket setelah penggunaan pertama

  3. Menggunakan Instalasi Lokal:

    • Verifikasi path absolut sudah benar di konfigurasi Anda
    • Pastikan server/index.js ada: ls -la server/index.js
    • Pastikan Anda menjalankan yarn build dengan sukses

  4. Verifikasi kredensial API: Pastikan kunci API Tomba Anda benar

  5. Periksa log Claude:

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

Masalah Spesifik NPX

"npx command not found":

  • Pastikan npm terinstal: npm --version
  • NPX disertakan dengan npm 5.2.0+, perbarui jika perlu: npm install -g npm

Paket tidak ditemukan:

  • Verifikasi paket telah dipublikasikan: npm view tomba-mcp-server
  • Coba bersihkan cache npm: npm cache clean --force

Selalu mengunduh paket:

  • Ini adalah perilaku normal dengan flag -y
  • NPX menyimpan cache paket setelah unduhan pertama
  • Untuk instalasi permanen, gunakan metode instalasi lokal

Kesalahan Autentikasi

  • Verifikasi kunci API Anda di https://app.tomba.io/dashboard
  • Pastikan variabel lingkungan diatur dengan benar di konfigurasi
  • Periksa apakah langganan API Anda aktif

Alat Tidak Merespons

  • Periksa batas laju API Tomba Anda
  • Verifikasi konektivitas jaringan
  • Tinjau log server untuk pesan kesalahan

Tentang Tomba

Didirikan pada tahun 2020, Tomba bangga menjadi sumber data alamat email yang paling andal, akurat, dan mendalam yang tersedia di mana pun. Kami memproses terabyte data untuk menghasilkan API Pencari email kami.

image

Berkontribusi

  1. Fork (https://github.com/tomba-io/tomba-mcp-server/fork)
  2. Buat branch fitur Anda (git checkout -b my-new-feature)
  3. Commit perubahan Anda (git commit -am 'Add some feature')
  4. Push ke branch (git push origin my-new-feature)
  5. Buat Pull Request baru

Lisensi

Silakan lihat file Lisensi untuk informasi lebih lanjut.

Dukungan