ICP备案查询工具 (Go)

纯 Go 实现的工信部 ICP 备案查询工具，支持域名、App、小程序、快应用的备案查询与违规查询。

原生支持 AI 集成：内置 MCP Server 可被 Claude、Cursor 等 AI Agent 直接调用，附带 Claude Code Skill 实现开箱即用的智能备案查询体验。

Inspired by ICP_Query（Python 版）。

CLI 查询	AI Agent 查询（MCP）
Web UI	AI Agent 查询小程序备案（MCP）

• 单条/批量 ICP 备案查询
• 违规域名、App、小程序、快应用查询
• Web UI 界面，支持查询历史与 Excel/JSON 导出
• MCP Server — AI Agent 可直接调用备案查询能力
• Claude Code Skill — 内置 Skill 文件，配置即用
• 代理池支持（本地 IPv6 / 隧道代理 / API 提取）
• 自动验证码识别与重试
• 纯 Go 实现，跨平台编译

前往 Releases 下载对应平台的压缩包，解压后将 icpcli 放入 PATH 即可。

git clone https://github.com/imxw/icp-query-go.git
cd icp-query-go
go build -o icpcli .

docker build -t icp-query .
docker run -p 8080:8080 icp-query

# 查询域名备案
icpcli query baidu.com

# 查询 App 备案
icpcli query 微信 -t app

# 查询小程序备案
icpcli query "北京百度网讯科技有限公司" -t mapp

# 查询违规域名
icpcli query baidu.com -t bweb

支持的查询类型：

# 从文件批量查询
icpcli batch -f domains.txt -t web

# 指定并发数和自动翻页
icpcli batch -f domains.txt -t web -j 10 --auto-page

# 启动 Web 服务（默认端口 8080）
icpcli serve

# 指定端口和配置
icpcli serve -p 8080 -c /path/to/config.yml

访问 http://localhost:8080 即可使用 Web 界面。

icpcli version
icpcli version -o json

# 启动 MCP Server
icpcli mcp

在 Claude Code 中配置：

# 方式一：命令行添加（icpcli 已在 PATH 中）
claude mcp add icp-query -- icpcli mcp

# 方式二：命令行添加（指定完整路径）
claude mcp add icp-query -- /path/to/icpcli mcp

或在项目 .mcp.json / ~/.claude/settings.json 中配置：

{
  "mcpServers": {
    "icp-query": {
      "command": "icpcli",
      "args": ["mcp"]
    }
  }
}

MCP 提供以下工具：

项目内置了 ICP 查询 skill，Claude Code 在项目目录下会自动识别。如需在其他项目中使用，将 .claude/skills/icp-query/SKILL.md 复制到目标项目的 .claude/skills/icp-query/ 目录即可。

Web 服务启动后提供以下 API：

本项目仅供学习和技术研究使用，不得用于任何商业或非法用途。

本项目通过非官方方式调用工信部 ICP 备案查询接口，可能违反相关服务条款，使用者需自行承担全部风险和责任。作者不对因使用本项目造成的任何直接或间接损失负责。

请遵守相关法律法规，合理使用。

MIT