English Français العربية

io.github.BigJai/opendirectories-business-data

السجل الرسمي الحكومة والقانون

Search 12M+ verified businesses across 10 countries via government registers.

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع io.github.BigJai/opendirectories-business-data؟

  • Lead generation — Find businesses by category, location, and quality score
  • Competitive analysis — Map competitors in any suburb or city
  • Market research — Analyse density, ratings, and digital presence
  • Business verification (KYB) — Verify against government registers
  • Franchise expansion — Identify underserved markets

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http opendirectories-business-data 'https://secure-wave--opendirectories-business-data.apify.actor/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "opendirectories-business-data": {
            "type": "http",
            "url": "https://secure-wave--opendirectories-business-data.apify.actor/mcp"
        }
    }
}
PYPI package opendirectories-mcp
Claude Code 
claude mcp add opendirectories-business-data -e 'APAC_SUPABASE_URL=<APAC_SUPABASE_URL>' -e 'APAC_SUPABASE_KEY=<your apac_supabase_key>' -e 'US_SUPABASE_URL=<US_SUPABASE_URL>' -e 'US_SUPABASE_KEY=<your us_supabase_key>' -e 'EU_SUPABASE_URL=<EU_SUPABASE_URL>' -e 'EU_SUPABASE_KEY=<your eu_supabase_key>' -- uvx opendirectories-mcp==0.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "opendirectories-business-data": {
            "command": "uvx",
            "args": [
                "opendirectories-mcp==0.1.0"
            ],
            "env": {
                "APAC_SUPABASE_URL": "<APAC_SUPABASE_URL>",
                "APAC_SUPABASE_KEY": "<your apac_supabase_key>",
                "US_SUPABASE_URL": "<US_SUPABASE_URL>",
                "US_SUPABASE_KEY": "<your us_supabase_key>",
                "EU_SUPABASE_URL": "<EU_SUPABASE_URL>",
                "EU_SUPABASE_KEY": "<your eu_supabase_key>"
            }
        }
    }
}

متغيرات البيئة

  • APAC_SUPABASE_URL APAC Supabase URL
  • APAC_SUPABASE_KEY سري APAC Supabase anon key
  • US_SUPABASE_URL US Supabase URL
  • US_SUPABASE_KEY سري US Supabase anon key
  • EU_SUPABASE_URL EU Supabase URL
  • EU_SUPABASE_KEY سري EU Supabase anon key

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. OpenDirectories MCP Server
  2. Quick Start
  3. Tools
  4. Data Sources
  5. Coverage
  6. Use Cases
  7. Self-Hosting
  8. License

OpenDirectories MCP Server

Search 12M+ verified businesses across 10 countries and 19 directories via the Model Context Protocol.

All data sourced from government registers and enriched with Google Maps ratings and AI descriptions.

Quick Start

Hosted (zero setup)

Add to your MCP client config (Claude Desktop, Cline, Cursor, etc.):

{
  "mcpServers": {
    "opendirectories": {
      "url": "https://secure-wave--opendirectories-business-data.apify.actor/mcp"
    }
  }
}
Install via PyPI
pip install opendirectories-mcp
{
  "mcpServers": {
    "opendirectories": {
      "command": "opendirectories-mcp",
      "env": {
        "APAC_SUPABASE_URL": "https://your-instance.supabase.co",
        "APAC_SUPABASE_KEY": "your-anon-key",
        "US_SUPABASE_URL": "https://your-instance.supabase.co",
        "US_SUPABASE_KEY": "your-anon-key",
        "EU_SUPABASE_URL": "https://your-instance.supabase.co",
        "EU_SUPABASE_KEY": "your-anon-key"
      }
    }
  }
}

Tools

search_businesses

Search across all records with rich filters.

ParameterTypeDescription
querystringBusiness name or type
countrystringISO code: AU, US, UK, CA, NZ, SG, IE, FR
directorystringDirectory ID (see list_directories)
statestringState/province code (e.g. NSW, CA, TX)
suburbstringSuburb or city name
has_phoneboolOnly businesses with phone numbers
min_ratingfloatMinimum Google rating (0-5)
limitintResults to return (1-50, default 10)
get_business

Get full details for a business by its ID.

ParameterTypeDescription
business_idintUnique business record ID
directorystringOptional directory to narrow search
get_competitors

Find competitors near a business location, ranked by quality score.

ParameterTypeDescription
business_namestringBusiness to find competitors for
suburbstringSuburb or city
countrystringCountry code (default AU)
directorystringDirectory to search within
limitintResults (1-20, default 10)
market_density

Analyse market saturation with rating distributions, digital presence metrics, and top-rated providers.

ParameterTypeDescription
categorystringBusiness type (e.g. dentist, plumber)
statestringState or province
suburbstringSuburb or city
countrystringCountry code (default AU)
directorystringDirectory to search within
verify_business

Verify a business against government registers with confidence scoring.

ParameterTypeDescription
business_namestringBusiness name to verify
countrystringCountry code (default AU)
abnstringAustralian Business Number (optional)
suburbstringSuburb (optional, improves accuracy)
list_directories

Returns all 19 directories with country and region metadata. No parameters.

Data Sources

RegionSourceDirectories
AustraliaASIC, NDIS, ACECQA, ACNCFinancial advisers, mortgage brokers, childcare, aged care, charities, manufacturers, disability providers, commercial finance, local services
United StatesCMS, IRSHealthcare providers, nonprofits, transport, education
United KingdomCompanies HouseUK companies
CanadaNational registerCanadian businesses
New ZealandCharities CommissionNZ charities
SingaporeACRASingapore companies
IrelandCROIrish charities
FranceINSEEFrench enterprises

Coverage

  • 12,160,000+ verified business records
  • 19 specialised directories
  • 10 countries (AU, US, UK, CA, NZ, SG, IE, FR + growing)
  • 3 regional databases (APAC, US, EU)
  • Google Maps ratings and review counts
  • AI-generated business descriptions

Use Cases

  • Lead generation — Find businesses by category, location, and quality score
  • Competitive analysis — Map competitors in any suburb or city
  • Market research — Analyse density, ratings, and digital presence
  • Business verification (KYB) — Verify against government registers
  • Franchise expansion — Identify underserved markets

Self-Hosting

Set environment variables for your Supabase instances:

export APAC_SUPABASE_URL=https://your-instance.supabase.co
export APAC_SUPABASE_KEY=your-anon-key
export US_SUPABASE_URL=https://your-instance.supabase.co
export US_SUPABASE_KEY=your-anon-key
export EU_SUPABASE_URL=https://your-instance.supabase.co
export EU_SUPABASE_KEY=your-anon-key
export PORT=5001

opendirectories-mcp

Or use Docker:

docker run -p 5001:5001 \
  -e APAC_SUPABASE_URL=... \
  -e APAC_SUPABASE_KEY=... \
  ghcr.io/bigjai/opendirectories-mcp

License

MIT

الأسئلة الشائعة

ما هو io.github.BigJai/opendirectories-business-data؟

Search 12M+ verified businesses across 10 countries via government registers.

كيف أثبّت io.github.BigJai/opendirectories-business-data؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http opendirectories-business-data 'https://secure-wave--opendirectories-business-data.apify.actor/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.BigJai/opendirectories-business-data إلى مفتاح API؟

نعم. يتطلب APAC_SUPABASE_KEY, US_SUPABASE_KEY, EU_SUPABASE_KEY، وتضبطها في إعداداته.

هل io.github.BigJai/opendirectories-business-data مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.BigJai/opendirectories-business-data؟

ينشره BigJai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.