Tomba MCP Server

chính thức

Tomba, công cụ tìm kiếm và xác minh email B2B độc đáo của bạn, cung cấp cơ sở dữ liệu khách hàng tiềm năng đặc biệt để mở rộng tiếp cận một cách dễ dàng và hiệu quả.

GitHub
7

Tài liệu

Tomba Máy chủ Tomba.io MCP

Máy chủ Model Context Protocol (MCP) để tích hợp với API Tomba.io. Máy chủ này cung cấp khả năng khám phá email, xác minh và làm giàu dữ liệu toàn diện thông qua giao diện MCP được chuẩn hóa.

Tính năng

Công cụ (12 công cụ khả dụng)

Tài nguyên (7 tài nguyên khả dụng)

  • tomba://api/status - Trạng thái API và thông tin tài khoản
  • tomba://domain/{domain} - Thông tin tên miền
  • tomba://email/{email} - Thông tin email
  • tomba://similar/{domain} - Phân tích tên miền tương tự
  • tomba://technology/{domain} - Thông tin stack công nghệ
  • tomba://docs/api - Tài liệu API
  • tomba://docs/tools - Tài liệu công cụ

Lời nhắc (16 quy trình dựng sẵn)

  • find_contact - Tìm thông tin liên hệ đầy đủ cho một người
  • verify_email_list - Xác minh hàng loạt địa chỉ email
  • research_company - Nghiên cứu liên hệ và cấu trúc công ty
  • enrich_lead - Làm giàu khách hàng tiềm năng với tất cả dữ liệu có sẵn
  • find_journalists - Tìm liên hệ nhà báo từ các bài viết
  • finder_phone - Tìm số điện thoại cho liên hệ
  • validate_phone - Xác thực số điện thoại
  • competitor_analysis - Phân tích đối thủ cạnh tranh bằng tên miền tương tự và công nghệ
  • technology_audit - Kiểm tra công nghệ toàn diện của một trang web
  • domain_insights - Nhận thông tin chi tiết toàn diện về tên miền bao gồm số lượng email và công nghệ
  • bulk_domain_research - Nghiên cứu nhiều tên miền để lấy số lượng email và thông tin cơ bản
  • find_target_companies - Tìm công ty với bộ lọc nâng cao (quy mô, loại hình, doanh thu, ngành)
  • market_research - Nghiên cứu công ty trong phân khúc thị trường với bộ lọc toàn diện
  • lead_generation - Tạo khách hàng tiềm năng bằng cách tìm công ty và liên hệ của họ
  • prospect_enrichment - Làm giàu triển vọng công ty với dữ liệu toàn diện
  • industry_analysis - Phân tích công ty trong một ngành với phân khúc chi tiết

Tùy chọn bộ lọc cho Lời nhắc tìm kiếm công ty

Bộ lọcGiá trị khả dụng
Quy mô1-10 (Siêu nhỏ), 11-50 (Nhỏ), 51-250 (Vừa), 251-1K (Trung bình-lớn), 1K-5K (Lớn), 5K-10K (Rất lớn), 10K-50K (Doanh nghiệp), 50K-100K (Khổng lồ), 100K+ (Toàn cầu)
Loại hìnhgiáo dục, chính phủ, phi lợi nhuận, tư nhân, công cộng, cá nhân
Doanh thu$0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
NgànhDựa trên Mã ngành LinkedIn V2 (hơn 140 ngành bao gồm Phần mềm máy tính, Dịch vụ tài chính, Bệnh viện & Chăm sóc sức khỏe, v.v.)

Tùy chọn truyền tải

  • stdio - Đầu vào/đầu ra tiêu chuẩn (mặc định, cho Claude Desktop)
  • http - Máy chủ HTTP với các điểm cuối REST

Cài đặt

Điều kiện tiên quyết

Ảnh chụp màn hình

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4 Screenshot 5

Tùy chọn 1: Cài đặt qua NPX (Khuyến nghị)

Cách dễ nhất để sử dụng máy chủ Tomba MCP là qua npx, không yêu cầu sao chép kho lưu trữ:

macOS/Linux

Thêm vào claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json) của bạn:

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

Thêm vào claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json) của bạn:

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

Lưu ý: Cờ -y tự động chấp nhận lời nhắc cài đặt và npx sẽ luôn tải phiên bản mới nhất.

Tùy chọn 2: Cài đặt từ mã nguồn

Nếu bạn muốn sửa đổi máy chủ hoặc đóng góp phát triển:

# 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

Cấu hình

Kỹ năng OpenClaw

Kho lưu trữ này hiện bao gồm kỹ năng OpenClaw cục bộ không gian làm việc tại skills/tomba-contact-intelligence/SKILL.md.

Kỹ năng được thiết kế để giúp OpenClaw chọn đúng công cụ Tomba MCP cho các quy trình khám phá liên hệ, nghiên cứu công ty, xác minh email, tra cứu số điện thoại và làm giàu triển vọng.

Để sử dụng:

  1. Mở kho lưu trữ này làm không gian làm việc OpenClaw của bạn, hoặc sao chép thư mục skills/tomba-contact-intelligence vào thư mục kỹ năng OpenClaw của bạn.
  2. Đảm bảo máy chủ Tomba MCP được cấu hình và khả dụng cho OpenClaw.
  3. Bắt đầu phiên OpenClaw mới để kỹ năng được tải.

Lời nhắc ví dụ:

  • "Tìm liên hệ tốt nhất cho quan hệ đối tác tại stripe.com và xác minh email trước khi trả về."
  • "Nghiên cứu các công ty fintech ở Đức, sau đó xác định liên hệ bán hàng tiềm năng cho các kết quả hàng đầu."
  • "Làm giàu triển vọng này với email, điện thoại, công nghệ công ty và đối thủ cạnh tranh tương tự: [email protected]"

Thiết lập Claude Desktop

Để sử dụng máy chủ này với Claude Desktop, thêm cấu hình vào tệp claude_desktop_config.json của bạn.

Sử dụng NPX (Khuyến nghị)

Phương pháp này tự động sử dụng phiên bản đã xuất bản mới nhất:

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

Sử dụng cài đặt cục bộ

Nếu bạn đã xây dựng từ mã nguồn, sử dụng đường dẫn tuyệt đối đến cài đặt của bạ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"
            }
        }
    }
}

Lưu ý quan trọng:

  • Thay thế your-api-key-here và your-secret-key-here bằng thông tin xác thực API Tomba thực tế của bạn
  • Đối với cài đặt cục bộ, thay thế /ABSOLUTE/PATH/TO/tomba-mcp-server bằng đường dẫn đầy đủ đến thư mục cài đặt của bạn
  • Khởi động lại Claude Desktop sau khi cập nhật cấu hình

Lấy thông tin xác thực API Tomba

  1. Truy cập https://tomba.io
  2. Đăng ký tài khoản hoặc đăng nhập
  3. Điều hướng đến bảng điều khiển của bạn
  4. Đi đến cài đặt API
  5. Sao chép Khóa API và Khóa bí mật của bạn

Thay thế: Sử dụng truyền tải HTTP

Đối với truyền tải HTTP với 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"
            }
        }
    }
}

Đối với truyền tải HTTP với cài đặt cục bộ:

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

Sử dụng

Tùy chọn dòng lệnh

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

Máy chủ HTTP độc lập

Bạn cũng có thể chạy máy chủ như một dịch vụ HTTP độc lập:

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

Điểm cuối API HTTP

  • POST /mcp - Gửi yêu cầu JSON-RPC
  • GET /mcp - Sự kiện do máy chủ gửi cho thông báo (yêu cầu tiêu đề X-Session-Id)
  • DELETE /mcp - Kết thúc phiên (yêu cầu tiêu đề X-Session-Id)
  • GET /health - Điểm cuối kiểm tra sức khỏe
  • GET /sessions - Liệt kê phiên hoạt động (yêu cầu xác thực)

Ví dụ yêu cầu 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
  }'

🔧 Phát triển

Lệnh phát triển

# 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

🔍 Gỡ lỗi & Kiểm thử

MCP Inspector (Khuyến nghị)

Cách dễ nhất để kiểm thử và gỡ lỗi máy chủ MCP của bạn:

# Build and launch MCP Inspector
yarn debug

Thao tác này mở giao diện web nơi bạn có thể:

  • 📋 Xem tất cả công cụ khả dụng
  • 🧪 Kiểm thử công cụ tương tác
  • 📊 Kiểm tra yêu cầu/phản hồi
  • 🐛 Gỡ lỗi thời gian thực

Phương pháp gỡ lỗi thay thế

# 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

Gỡ lỗi VS Code

Nếu sử dụng VS Code, sử dụng cấu hình gỡ lỗi đi kèm:

  • Debug MCP Server: Gỡ lỗi JavaScript đã biên dịch
  • Debug TypeScript: Gỡ lỗi trực tiếp mã nguồn TypeScript
  • Debug with Inspector: Gỡ lỗi với MCP Inspector
  • Run Tests: Gỡ lỗi kiểm thử Jest

Xem DEBUG_GUIDE.md để biết hướng dẫn gỡ lỗi toàn diện.

🧪 Kiểm thử từng công cụ

1. Tìm kiếm tên miền

Tìm kiếm địa chỉ email liên kết với tên miền.

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

Phản hồi:

{
  "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. Trình tìm email

Tạo địa chỉ email có khả năng từ tên miền, tên và họ.

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

Phản hồi:

{
    "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. Trình xác minh email

Xác minh khả năng gửi địa chỉ email và kiểm tra sự hiện diện trong cơ sở dữ liệu.

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

Phản hồi:

{
    "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. Làm giàu email

Làm giàu địa chỉ email với thông tin liên hệ bổ sung.

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

Phản hồi:

{
    "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. Trình tìm tác giả

Tìm địa chỉ email của tác giả bài viết từ URL.

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

Phản hồi:

{
    "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. Trình tìm LinkedIn

Tìm địa chỉ email từ URL hồ sơ LinkedIn.

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

Phản hồi:

{
    "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. Trình tìm số điện thoại

Tìm kiếm số điện thoại dựa trên email, tên miền hoặc hồ sơ LinkedIn.

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

Phản hồi:

{
    "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. Trình xác thực số điện thoại

Xác thực số điện thoại và kiểm tra thông tin nhà mạng.

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

Phản hồi:

{
    "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. Số lượng email

Lấy tổng số địa chỉ email cho một tên miền.

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

Phản hồi:

{
    "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. Trình tìm tương tự

Tìm tên miền tương tự dựa trên một tên miền cụ thể.

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

Phản hồi:

{
    "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. Trình tìm công nghệ

Tiết lộ ngay lập tức stack công nghệ của bất kỳ trang web nào.

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

Phản hồi:

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

12. Tìm kiếm công ty

Tìm kiếm công ty bằng truy vấn ngôn ngữ tự nhiên với các bộ lọc nâng cao bao gồm vị trí, ngành, quy mô và doanh thu.

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

Phản hồi:

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

Bộ lọc khả dụng:

  • location_city: Lọc theo thành phố với mảng bao gồm/loại trừ
  • location_state: Lọc theo bang với mảng bao gồm/loại trừ
  • location_country: Lọc theo quốc gia với mảng bao gồm/loại trừ
  • industry: Lọc theo ngành (dựa trên Mã ngành LinkedIn V2 - hơn 140 ngành)
  • type: Lọc theo loại hình công ty: education, government, nonprofit, private, public, personal
  • size: Lọc theo quy mô công ty: 1-10, 11-50, 51-250, 251-1K, 1K-5K, 5K-10K, 10K-50K, 50K-100K, 100K+
  • revenue: Lọc theo phạm vi doanh thu: $0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
  • founded: Lọc theo năm thành lập với mảng bao gồm/loại trừ
  • keywords: Lọc theo từ khóa với mảng bao gồm/loại trừ
  • sic: Lọc theo mã SIC với mảng bao gồm/loại trừ
  • naics: Lọc theo mã NAICS với mảng bao gồm/loại trừ
  • similar: Lọc theo tên miền tương tự với mảng bao gồm/loại trừ

Giới hạn tốc độ & Sử dụng

Giới hạn tốc độ API

Tomba.io triển khai giới hạn tốc độ dựa trên gói đăng ký của bạn:

  • Gói Miễn phí: 50 yêu cầu mỗi tháng
  • Gói Tăng trưởng: 5.000 yêu cầu mỗi tháng + 10.000 yêu cầu xác minh
  • Gói Chuyên nghiệp: 10.000 yêu cầu mỗi tháng
  • Gói Doanh nghiệp: 50.000 yêu cầu mỗi tháng
  • Gói Tùy chỉnh: Giới hạn tùy chỉnh

Tìm hiểu thêm về Các gói giá Tomba.

Tiêu đề giới hạn tốc độ

Mỗi phản hồi API bao gồm thông tin giới hạn tốc độ:

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

Tìm hiểu thêm về Giới hạn tốc độ API Tomba.

Xử lý giới hạn tốc độ

Khi bạn vượt quá giới hạn tốc độ, API trả về trạng thái 429 Too Many Requests với:

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

Thực hành tốt nhất

  1. Giám sát sử dụng: Kiểm tra bảng điều khiển của bạn tại tomba.io/dashboard
  2. Triển khai Backoff: Xử lý phản hồi 429 với backoff theo cấp số nhân
  3. Hoạt động hàng loạt: Sử dụng tìm kiếm tên miền cho nhiều email từ cùng một tên miền
  4. Lưu trữ kết quả: Lưu trữ kết quả cục bộ để tránh yêu cầu trùng lặp
  5. Lập kế hoạch phù hợp: Nâng cấp gói dựa trên mô hình sử dụng

Mẹo sử dụng

  • Tìm kiếm tên miền trả về nhiều email mỗi yêu cầu (hiệu quả hơn tra cứu riêng lẻ)
  • Xác minh email chỉ tiêu thụ tín dụng cho định dạng email hợp lệ
  • Trình tìm số điện thoại có thể trả về nhiều số mỗi yêu cầu
  • Làm giàu cung cấp dữ liệu toàn diện trong một yêu cầu duy nhất

Khắc phục sự cố

Máy chủ không khởi động trong Claude Desktop

  1. Kiểm tra phiên bản Node.js: Đảm bảo bạn có Node.js 18 trở lên

    node --version

  2. Sử dụng NPX:

    • Đảm bảo bạn có kết nối internet ổn định cho lần chạy đầu tiên
    • Cờ -y sẽ tự động chấp nhận cài đặt
    • NPX sẽ lưu trữ gói sau lần sử dụng đầu tiên

  3. Sử dụng cài đặt cục bộ:

    • Xác minh đường dẫn tuyệt đối chính xác trong cấu hình của bạn
    • Đảm bảo server/index.js tồn tại: ls -la server/index.js
    • Đảm bảo bạn đã chạy yarn build thành công

  4. Xác minh thông tin xác thực API: Đảm bảo khóa API Tomba của bạn chính xác

  5. Kiểm tra nhật ký Claude:

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

Sự cố cụ thể với NPX

"Không tìm thấy lệnh npx":

  • Đảm bảo npm được cài đặt: npm --version
  • NPX đi kèm với npm 5.2.0+, cập nhật nếu cần: npm install -g npm

Không tìm thấy gói:

  • Xác minh gói đã được xuất bản: npm view tomba-mcp-server
  • Thử xóa bộ nhớ cache npm: npm cache clean --force

Luôn tải xuống gói:

  • Đây là hành vi bình thường với cờ -y
  • NPX lưu trữ gói sau lần tải xuống đầu tiên
  • Để cài đặt vĩnh viễn, sử dụng phương pháp cài đặt cục bộ

Lỗi xác thực

  • Xác minh khóa API của bạn tại https://app.tomba.io/dashboard
  • Đảm bảo biến môi trường được đặt đúng trong cấu hình
  • Kiểm tra đăng ký API của bạn đang hoạt động

Công cụ không phản hồi

  • Kiểm tra giới hạn tốc độ API Tomba của bạn
  • Xác minh kết nối mạng
  • Xem lại nhật ký máy chủ để tìm thông báo lỗi

Về Tomba

Được thành lập năm 2020, Tomba tự hào là nguồn dữ liệu địa chỉ email đáng tin cậy, chính xác và chuyên sâu nhất hiện có. Chúng tôi xử lý terabyte dữ liệu để tạo ra API Trình tìm email của mình.

image

Đóng góp

  1. Fork nó (https://github.com/tomba-io/tomba-mcp-server/fork)
  2. Tạo nhánh tính năng của bạn (git checkout -b my-new-feature)
  3. Commit thay đổi của bạn (git commit -am 'Add some feature')
  4. Đẩy lên nhánh (git push origin my-new-feature)
  5. Tạo Pull Request mới

Giấy phép

Vui lòng xem tệp License để biết thêm thông tin.

Hỗ trợ