开发者文档

概览

天眼 AI 通过 MCP 标准协议、命令行工具和可复用 SKILL，将天眼查企业数据接入主流 AI 工具和自动化工作流。

选择建议：

• AI 对话中自动查企业信息 → MCP
• 排查数据、验证接口、接入脚本或 CI 流程 → CLI
• 完成标准化报告或业务流程（KYB、授信尽调、合同主体核验）→ SKILL

核心服务地址

推荐鉴权方式：OAuth。以下为核心服务信息；API Key 仅保留给不支持 OAuth 的旧客户端。

Json{
  "mcp_endpoint": "https://mcp.tianyancha.com/mcp",
  "server_name": "tyc-mcp",
  "auth_mode": "OAuth (recommended)",
  "api_key_header": "Authorization: YOUR_API_KEY (legacy compatibility)"
}

不支持 OAuth 的兼容客户端可继续使用 Authorization: YOUR_API_KEY，也兼容 Authorization: Bearer YOUR_API_KEY。

不要将真实 API Key 写入公开仓库、截图或共享文档。

快速开始

前置条件

• 已注册天眼查账号；推荐通过 OAuth 登录，无需预先复制 API Key
• 使用 MCP 客户端时，需支持 Streamable HTTP MCP，或通过 npx mcp-remote 转发
• 使用 CLI 时，本地需安装 Node.js 和 npm

第一步：登录天眼AI

默认使用 OAuth Device Flow，不在提示词、配置文件或对话中传递明文 API Key。

Bashtyc login --no-open --no-block
# 打开命令输出的授权链接，输入 6 位验证码并确认授权
tyc login --resume

如环境允许自动打开浏览器，也可直接运行 tyc login，通过 PKCE 完成授权。

第二步：选择接入方式

一键部署（推荐，OAuth）

在天眼AI首页登录后复制一键接入提示词并交给 AI Agent，Agent 会先识别自身能力：支持本地命令时安装 tyc-cli 与天眼AI Skill，并通过 Device Flow 引导用户授权；支持 Remote MCP OAuth 时按 MCP 元数据发起授权；两者均不支持时再进入 API Key 兼容路径。

一键部署由 Agent 自动完成安装、OAuth 授权提示、必要的重启提示和自检。验证通过后，Agent 回复用户「天眼AI已接入」。

兼容接入：手动配置 MCP

仅当客户端不支持 Remote MCP OAuth 时，才将 API Key 写入 MCP 配置。各平台详细步骤见「MCP 接入 → 分平台手动配置（API Key 兼容）」：

Json{
  "mcpServers": {
    "tyc-mcp": {
      "url": "https://mcp.tianyancha.com/v1",
      "headers": {
        "Authorization": "YOUR_API_KEY"
      }
    }
  }
}

兼容接入：手动配置 CLI

CLI 默认使用 tyc login；仅在无法完成 OAuth 登录、但已有兼容 Key 时使用下列初始化方式。

Bashnpm install -g tyc-cli
tyc init --url "https://mcp.tianyancha.com/v1" --authorization "YOUR_API_KEY"

第三步：验证

MCP 验证——在配置好的 AI 对话框中输入：

Plain Text请使用 tyc-mcp 查询乐视网信息技术（北京）股份有限公司的基本工商信息。

能返回企业名称、统一社会信用代码、登记状态、法定代表人、注册资本、成立日期等字段，即接入成功。

CLI 验证：

Bashtyc company registration-info "乐视网信息技术（北京）股份有限公司" --head 80

返回包含 name、creditCode、regStatus、legalPersonName、regCapital 等字段的 JSON，即验证通过。

MCP 接入

接入参数

配置

推荐配置（平台原生支持 Streamable HTTP 与 Remote MCP OAuth）：

Json{
  "mcpServers": {
    "tyc-mcp": {
      "url": "https://mcp.tianyancha.com/mcp"
    }
  }
}

API Key 兼容配置（平台不支持 Remote MCP OAuth 时使用）：

Json{
  "mcpServers": {
    "tyc-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.tianyancha.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "YOUR_API_KEY"
      }
    }
  }
}

调用建议

• 用户输入简称或模糊名称时，先做实体锚定，再进行下游查询
• 已知统一社会信用代码时，可直接用作 searchKey
• 高风险或合规场景，建议先调用概要层，根据 _summary、CLI 分层列表，或 MCP get_company_capabilities 返回的工具清单继续下钻
• 不要在 Prompt、截图、公开仓库或协作文档中暴露真实 API Key

分平台手动配置

以下手动配置仅用于不支持 Remote MCP OAuth 的兼容场景。新接入优先使用天眼AI一键接入或客户端原生 OAuth。

配置完成后，可以用以下 Prompt 验证接入是否正常：

Plain Text请使用 tyc-mcp 查询乐视网信息技术（北京）股份有限公司的基本工商信息。

能返回企业名称、统一社会信用代码、登记状态、法定代表人、注册资本等字段，即接入成功。

Trae

1. 点击左上角 TRAE → 设置，进入 MCP 相关设置。
2. 点击添加 - 手动配置，勾选启用项目级 MCP。
3. 打开天眼 AI 接入指南，复制 MCP 配置信息，粘贴到配置框内并保存。
4. 验证 Prompt：请调用名为 "tyc-mcp" 的 MCP 工具，分析一下乐视网信息技术（北京）股份有限公司的股权结构。

Cursor

1. Cursor → Preferences → Cursor Settings。
2. 搜索框输入 Tools & MCP，点击 Add Custom MCP，打开 mcp.json。
3. 复制 MCP 配置信息，写入 mcp.json 并保存；若文件已有其他配置，将 tyc-mcp 合并进 mcpServers 对象。
4. Tools 列表中出现 tyc-mcp 即配置成功。
5. 验证 Prompt：请调用名为 "tyc-mcp" 的 MCP 工具，分析一下乐视网信息技术（北京）股份有限公司的股权结构。

阿里云百炼

1. MCP 管理 → 自定义服务 → 创建 MCP 服务 → 脚本部署，选择 npx，填入以下配置（将 YOUR_API_KEY 替换为自己的 Key）：

Json{
  "mcpServers": {
    "tyc-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.tianyancha.com/v1",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "YOUR_API_KEY"
      }
    }
  }
}

1. 创建或编辑 Agent：创建应用 → 智能体应用 → Agent2.0 → 添加 MCP → 选择自定义 MCP → 点击添加全部。

CherryStudio

1. Cherry Studio → 关于 Cherry Studio → MCP 服务器 → 添加 → 从 JSON 导入。
2. 复制 MCP 配置信息，粘贴到弹窗内并确定。
3. 确认服务列表中有 tyc-mcp，右侧开关已打开。
4. 进入 tyc-mcp 设置，将类型改为可流式传输的 HTTP 并保存。
5. 对话前点击对话框下方 MCP 服务器 按钮，手动选择 tyc-mcp。
6. 验证 Prompt：分析一下乐视网信息技术（北京）股份有限公司的股权结构。

Claude Desktop（Cowork）

配置分三步：开启开发者模式 → 写入 MCP 配置 → 完全重启。

步骤 1：开启开发者模式

Help → Troubleshooting → Enable Developer Mode，顶部栏出现 Developer 选项即为成功。

步骤 2：写入 MCP 配置

Developer → Open App Config File，在配置文件中写入（将 YOUR_API_KEY 替换为自己的 Key）：

Json{
  "mcpServers": {
    "tyc-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.tianyancha.com/v1",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "YOUR_API_KEY"
      }
    }
  }
}

步骤 3：完全退出并重启 Claude Desktop

重启后若提示 tyc-mcp 无法连接，先检查 Node.js 和 npx：

Bashnode -v && npx -v

如未安装，macOS 可通过 Homebrew 安装：

Bash# 安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node

# 验证
node -v

Windsurf

1. Windsurf → Preference → Windsurf Settings，搜索框输入 MCP，点击 Open MCP registry。
2. 点击右侧设置按钮，打开 mcp_config.json。
3. 复制 MCP 配置信息，写入配置文件并保存：
   • 配置文件为空时，直接粘贴完整配置
   • 配置文件非空时，将 tyc-mcp 合并进 mcpServers 对象，注意 JSON 逗号位置
4. 验证 Prompt：请调用名为 "tyc-mcp" 的 MCP 工具，分析一下乐视网信息技术（北京）股份有限公司的股权结构。

CLI 接入

tyc-cli 适合在本地、脚本或自动化流程中直接调用天眼查数据。返回原始 JSON，不经过 LLM 推理，适合数据验证、排障和确定性数据获取。

安装与初始化

Bashnpm install -g tyc-cli

# 推荐：浏览器 OAuth 登录
tyc login

# Agent / 非阻塞环境：Device Flow
tyc login --no-open --no-block
# 在网页输入 6 位验证码并确认授权后
tyc login --resume

API Key 兼容模式：

Bashtyc init --url "https://mcp.tianyancha.com/v1" --authorization "YOUR_API_KEY"

OAuth access token、refresh token 与服务地址写入 ~/.tyc/config.json（权限 600）；Device Flow 待完成状态临时保存在 ~/.tyc/oauth_pending.json。使用 tyc init --authorization 会切回 API Key 兼容模式，并清除 OAuth 刷新上下文。

基本命令

Bashtyc --version
tyc --help
tyc layers --md

tyc --help 展示 4 层工具架构、6 大模块和输出控制参数。完整工具清单可通过 tyc L1 list --md、tyc L2 list --md 查看。

输出控制参数

常用命令

Bash# 实体锚定：输入可能是简称时，先检索候选企业
tyc company companies "乐视网" --head 60

# 工商登记信息
tyc company registration-info "乐视网信息技术（北京）股份有限公司" --head 80

# 股东结构
tyc company shareholder-info "乐视网信息技术（北京）股份有限公司" --head 80

# 风险总览
tyc risk overview "乐视网信息技术（北京）股份有限公司" --head 80

# 知识产权
tyc intellectual_property trademark-info "乐视网信息技术（北京）股份有限公司" --head 80
tyc intellectual_property patent-info "乐视网信息技术（北京）股份有限公司" --head 80
tyc intellectual_property software-copyright-info "乐视网信息技术（北京）股份有限公司" --head 80

# 经营与公示
tyc operation bidding-info "乐视网信息技术（北京）股份有限公司" --head 80
tyc operation qualifications "乐视网信息技术（北京）股份有限公司" --head 80
tyc operation news-sentiment "乐视网信息技术（北京）股份有限公司" --head 80

# 历史信息
tyc history historical-overview "乐视网信息技术（北京）股份有限公司" --head 80
tyc history historical-registration "乐视网信息技术（北京）股份有限公司" --head 80

# 董监高画像（需同时传企业名称和人员姓名）
tyc executive person-profile "乐视网信息技术（北京）股份有限公司" --humanName "刘延峰" --head 80

董监高类工具需要企业名称和人员姓名双参数锚定，避免同名误查。人员姓名通过 --humanName 传入；完整参数以 tyc executive --help 为准。

常见返回字段

以工商登记为例：

SKILL 使用

天眼AI的 Skill 采用智能路由设计，Agent 会根据用户需求自动路由所需工具，推荐搭配 CLI 使用。

在此处查看Skill 文档

使用方式

在支持 Skill 的 Agent 中加载后，可以直接提出业务需求，或显式使用 /tyc-it：

Plain Text/tyc-it 查一下乐视网信息技术（北京）股份有限公司的工商信息和风险概况
/tyc-it 帮我核验这个合作方是否存在明显经营、司法或行政风险
/tyc-it 查询宁德时代的股权结构和对外投资情况

典型场景

数据能力与工具体系

天眼 AI 当前提供 162 个企业数据工具，按 6 大模块组织，通过 4 层架构做渐进式披露。默认只暴露少量高信息密度工具，再按需下钻，降低工具选择错误率。

6 大数据模块

4 层工具架构

推荐顺序：L0 锚定企业 → L1 看摘要 → 根据 _summary、CLI 分层列表，或 MCP get_company_capabilities 返回的工具清单进入 L2/L3。

L2 优先工具

当 Agent 不确定某个模块该先下钻哪个明细工具时，可参考：

数据权益与阶段说明

早鸟推广期至 2026-08-31，早鸟推广期使用天眼AI，可享10倍调用额度，并可体验全部数据权益。

以下为正式期权益矩阵，自 2026-09-01 起生效。

常见问题

接入与配置

工具没有出现在 AI 客户端里

优先确认客户端是否已完成 OAuth 授权：Remote MCP 客户端应能根据服务端 metadata 拉起授权；CLI 可运行 tyc login 或 tyc login --resume 完成登录。仅在 API Key 兼容模式下，才检查 mcpServers 中的 Authorization。大多数客户端需要完全退出并重启后才会重新加载 MCP 配置。

配置已经粘贴进去，但提示「未找到 MCP Server」

逐项检查：

• OAuth 模式：确认授权页已完成确认，Device Flow 验证码未过期；未完成时重新运行 tyc login --no-open --no-block
• OAuth 模式：网页授权完成后运行 tyc login --resume；若提示没有 pending 状态，重新发起登录
• API Key 兼容模式：确认 JSON 合并进正确配置文件，外层字段名为 mcpServers
• API Key 兼容模式：确认 url 与 Authorization 未被截断，且没有多余空格或引号
• 平台不支持 Streamable HTTP 时，可切换到 mcp-remote 转发方式

调用时出现认证或限流错误

Cursor / 百炼 / Coze / CherryStudio 怎么接入？

支持 Remote MCP OAuth 的平台优先直接填写服务 URL，并按页面提示完成 OAuth；不支持 OAuth 时，再在「自定义 MCP / 远程工具」入口配置 url 与 Authorization。详见「MCP 接入 → 分平台手动配置（API Key 兼容）」。

CLI 和 MCP 能同时用吗？

可以。二者按场景选择，但共用同一账号 uid 层的权益额度池；OAuth token 与兼容 API Key 都会归属到账号，额度不绑定某一把 Key。

额度与计费

不同会员的额度是多少？用完怎么办？

推广期（至 2026-08-31）：Free 为 100 次/天、1,000 次/月；VIP 为 1,000 次/天、10,000 次/月；SVIP 为 10,000 次/天、100,000 次/月。

正式期（2026-09-01 起）：Free 为 10 次/天、100 次/月；VIP 为 100 次/天、1,000 次/月；SVIP 为 1,000 次/天、10,000 次/月。额度数值与生效时间以后端配置为准。

日额度在次日 00:00 重置，月额度在次月 1 日 00:00 重置；任一额度用满后，MCP / CLI 调用会被拦截且不扣减额度。仅成功返回数据的有效调用扣减；报错、限流、鉴权失败、参数错误、空结果与无数据均不扣减。

额度用完后，可等待重置或升级会员；升级后的会员额度仍不能满足时，请联系销售增购，或拨打 400-608-0000 咨询。

历史 API Key 需要更换吗？

不需要。历史通用 Key 由后端无感替换或映射，在天眼AI的 MCP / CLI 入口持续可用；用户无需换发，也没有用户可见的停用节点。

Device Flow 验证码过期怎么办？

重新运行 tyc login --no-open --no-block 获取新的授权链接和 6 位验证码；网页确认后再运行 tyc login --resume。

数据查询

工商 / 司法 / 知产 / 经营 / 历史 / 董监高，该用哪个模块？

天眼 AI 已按能力域拆分为 6 个模块：

• company：工商登记、股东、实控人等基础信息
• risk：司法风险、失信被执行、行政处罚等
• intellectual_property：商标、专利、软著、知产出质
• operation：招投标、资质、融资、舆情等经营与公示数据
• history：历史工商、历史股东等变更前的历史信息
• executive：董监高人员画像与风险信息

不确定从哪个模块切入时，从 L1 概要层开始，再根据 _summary 摘要或 MCP get_company_capabilities 返回的工具清单进入对应的 L2/L3 工具。

searchKey 传什么？企业名称还是统一社会信用代码？

两者都可以。已知统一社会信用代码时优先使用，精度更高；只有名称时，尽量使用与工商登记一致的完整全称，可提高命中率。若只有简称或模糊描述，先用 L0 实体锚定检索候选企业：

Bashtyc company companies "乐视网" --head 60

L0 返回的候选列表包含企业全名、统一社会信用代码、登记状态和法定代表人，确认唯一主体后再查询。

为什么要先做实体锚定？

企业简称可能对应多个主体——同一简称在不同省市可能存在多家公司。L0 返回的候选列表可以避免查错主体。

环境与工具

本地提示 node 或 npx 不存在

mcp-remote 和 tyc-cli 都依赖 Node.js / npm。请到https://nodejs.org/安装，安装后验证：

Bashnode -v && npx -v && npm -v

macOS 可用 Homebrew 安装：brew install node

CLI 初始化后配置保存在哪里？

OAuth 登录状态默认保存在 ~/.tyc/config.json；未完成的 Device Flow 临时状态保存在 ~/.tyc/oauth_pending.json。重新授权运行 tyc login；切回 API Key 兼容配置运行 tyc init --authorization "YOUR_API_KEY"。

CLI 输出太长怎么处理？

Bashtyc risk overview "乐视网信息技术（北京）股份有限公司" --head 80
tyc company shareholder-info "乐视网信息技术（北京）股份有限公司" --output-file ./shareholders.json --head 40

天眼AI MCP/CLI 分别都有哪些工具？

天眼AI MCP/CLI 的工具清单可以询问您的 AI Agent 工具探知。截至2026年7月31日，天眼AI MCP/CLI 的工具清单如下：天眼AI MCP & CLI 工具清单.md。