# CNBizAPI — China Business Intelligence MCP Server

> Query any Chinese company with one API call. REST API + MCP Server for AI Agents.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Features

- 🇨🇳 **77M+ Chinese enterprises** — covers ALL registered companies in China
- ⚡ **MCP Native** — works with Claude Code, Cursor, OpenClaw out of the box
- 🔄 **Daily updates** — data synced from official government registries (SAMR)
- 💰 **Pay-per-query** — free 200 queries/month, then from $0.057/query
- 🌍 **Bilingual** — all responses in Chinese + English
- 🔑 **Self-service** — register → API key → start querying in 60 seconds

## Quick Start

### 1. Get Your Free API Key

```bash
curl -X POST https://api.cnbizapi.com/v1/auth/register \
 -H "Content-Type: application/json" \
 -d '{"email":"you@example.com","password":"your_password"}'
```

Save the `api_key` from the response (format: `cbz_xxxx`).

### 2. Add to Claude Code / Cursor

Add to your MCP settings:

```json
{
 "mcpServers": {
 "cnbizapi": {
 "url": "https://mcp.cnbizapi.com/mcp",
 "headers": {
 "Authorization": "Bearer YOUR_API_KEY"
 }
 }
 }
}
```

### 3. Ask Your AI

- "Search for Tencent's company information"
- "查一下华为技术有限公司的股东信息"
- "Verify if USCC 91440300708461136T matches 腾讯科技 (深圳) 有限公司"

## 12 Tools

| Tool | Description | Credits |
|------|------------|---------|
| `search_company` | Fuzzy search / 企业模糊搜索 | Free |
| `get_company_basic` | Basic info (30+ fields) / 基本工商信息 | Free |
| `verify_company` | 2-element verification / 二要素验证 | Free |
| `get_shareholders` | Shareholders / 股东信息 | 1 |
| `get_executives` | Key personnel / 高管信息 | 1 |
| `get_investments` | Investments / 对外投资 | 1 |
| `get_legal_risks` | Legal risks / 法律风险 | 4 |
| `get_ip_pledge` | IP pledge / 知识产权出质 | 2 |
| `get_annual_report` | Annual report / 年报数据 | 4 |
| `get_branches` | Branches / 分支机构 | 1 |
| `get_changes` | Changes / 变更记录 | 1 |
| `get_company_full` | Full profile / 全量画像 | 8 |

## REST API

Base URL: `https://api.cnbizapi.com/v1`

```bash
# Search
curl -H "Authorization: Bearer YOUR_KEY" \
 "https://api.cnbizapi.com/v1/company/search?keyword=腾讯"

# Basic info
curl -H "Authorization: Bearer YOUR_KEY" \
 "https://api.cnbizapi.com/v1/company/basic?q=91440300708461136T"

# Full profile
curl -H "Authorization: Bearer YOUR_KEY" \
 "https://api.cnbizapi.com/v1/company/full?q=华为技术有限公司"
```

## Pricing

| Tier | Credits | Price | Per Credit |
|------|---------|-------|-----------|
| **Free** | 200/month | $0 | — |
| Starter | 200 | $19.99 | $0.100 |
| Pro | 800 | $59.99 | $0.075 |
| Business | 3,500 | $199.99 | $0.057 |

## Links

- 🌐 Website: [cnbizapi.com](https://cnbizapi.com)
- 📖 API Docs: [api.cnbizapi.com](https://api.cnbizapi.com)
- 🔌 MCP Server: `https://mcp.cnbizapi.com/mcp`

## License

MIT