
ICP_Query
查询域名、APP、小程序、快应用以及企业的ICP备案信息,提供完全本地化的API
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up ICP_Query (git-clone project) into my current project. Found on https://claudeers.com/icpquery Repo: https://github.com/HG-ha/ICP_Query Homepage/docs: — Detected install method: git-clone → git clone https://github.com/HG-ha/ICP_Query Category: uncategorized. Platforms: api, desktop, web, mobile. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: unknown; community-verified: false. Confirm the source before running anything.
git clone https://github.com/HG-ha/ICP_Query
// compatibility
| Platforms | api, desktop, web, mobile |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | — |
| Pricing | open-source |
| Language | Rust |
ICP_Query
注意: 开源目的仅学习交流逆向与验证码识别技术使用
📋 关于本项目
- ✅ ICP备案查询,基于Python,全异步构建的高性能ICP查询模块,支持分页查询
- ✅ 直接从工业和信息化部政务服务平台抓取实时数据,支持Web、APP、小程序、快应用名称查询
- ✅ 支持根据备案号查询,支持根据企业名称查询,支持违法违规域名、APP查询
- ✅ 提供简单易用的高性能接口以及发行版程序
- ✅ 自定义配置,适配多种代理和免代理方式,学习如何自定义配置以及代理
- ✅ 内置webui,默认开启,浏览器访问 http://127.0.0.1:16181 即可
- ✅ AMD 9600X 处理器平均识别仅需0.09s,支持模型加速
🎯 验证码识别效果(已适配最新滑块)
🚀 部署方式
1. Docker部署
docker run -d -p 16181:16181 --name ymicp yiminger/ymicp
2. 本地部署(可执行文件,Rust)
- 📥 Release下载可执行文件(仅提供 Rust 版
icpApi-rs的 Linux/Windows 二进制)
3. 源码部署(Python)
git clone https://github.com/HG-ha/ICP_Query.git
cd ICP_Query
uv init
uv venv --python 3.11
uv pip install -r src/python/requirements.txt
# 在仓库根目录运行(自动读取根目录 config.yml / templates / static)
uv run python src/python/icpApi.py
4. 源码部署(Rust)
cd src/rust
cargo run --release
Release 产物:仅 Rust 版 ymicp-*-amd64-rs.{tar.gz,zip}(可执行文件 icpApi-rs / icpApi-rs.exe)。Python 版不再提供预编译二进制,请使用 Docker 镜像或源码部署。
🔐 账号登录(公网部署)
对应 Issue #40。出口 IP 变动时可用账号密码保护 Web UI 与 API。
在 config.yml 中:
auth:
enable: true # 公网务必改为 true
secret: change-me # 请修改为随机字符串
session_hours: 72
users:
- username: admin
password: admin123 # 首次可用明文;保存配置后自动变为 sha256$...
- 登录:
POST /api/auth/login,或打开 Web UI 登录页 - API:Cookie
ymicp_session或头Authorization: Bearer <token> - 默认
enable: false,行为与旧版兼容
🧩 MCP 服务
对应 Issue #42。Python 与 Rust 均提供相同工具:icp_query(type/search/page_num/page_size)、icp_query_types。
stdio(Claude Desktop / Cursor 推荐):
# Python(源码部署)
python src/python/icpApi.py --mcp
# 也可:python src/python/mcp_server.py
# Rust(Release 二进制或源码)
./icpApi-rs --mcp
# 或:cargo run --release -- --mcp
Claude Desktop 示例(claude_desktop_config.json):
{
"mcpServers": {
"icp-query": {
"command": "python",
"args": ["H:/path/to/ICP_Query/src/python/icpApi.py", "--mcp"]
},
"icp-query-rs": {
"command": "H:/path/to/icpApi-rs",
"args": ["--mcp"]
}
}
}
Streamable HTTP(可选,两端一致):
mcp:
enable: true
port: 16182
主服务启动时会在独立端口监听 /mcp。也可单独启动:
./icpApi-rs --mcp-http
# Python 源码:python src/python/icpApi.py --mcp-http
→ http://127.0.0.1:16182/mcp
📱 Android 运行示例
我们提供了一个在 Android 设备上运行 ICP 查询的示例项目:
- 📲 ICP-for-Android - 在 Android 设备上使用 Python + ONNX Runtime 进行界面绘制和模型推理
💻 使用方法
使用查询模块
import asyncio
from ymicp import beian
async def main(name):
icp = beian()
query = await icp.ymApp(name)
print(query)
asyncio.run(main("微信"))
🔍使用icpApi查询接口
支持八种类型查询:
| 类型 | 说明 |
|---|---|
web | 网站 |
app | APP |
mapp | 小程序 |
kapp | 快应用 |
bweb | 违法违规网站 |
bapp | 违法违规APP |
bmapp | 违法违规小程序 |
bkapp | 违法违规快应用 |
示例请求
GET请求
-
URL格式:
http://0.0.0.0:16181/query/{type}?search={name} -
示例1: 查询域名
baidu.com备案信息curl http://127.0.0.1:16181/query/web?search=baidu.com -
示例2: 根据网站的备案号
京ICP证030173号查询备案信息curl http://127.0.0.1:16181/query/web?search=京ICP证030173号 -
示例3: 根据企业名称查询备案信息
curl http://127.0.0.1:16181/query/web?search=深圳市腾讯计算机系统有限公司 -
示例4: 根据企业名称查询备案信息,每页20条数据,查询第3页
curl http://127.0.0.1:16181/query/web?search=深圳市腾讯计算机系统有限公司&pageNum=3&pageSize=20
📊 响应参数说明
| 参数 | 说明 |
|---|---|
| lastPage | 据查询数量有多少页 |
| pages | 据查询数量有多少页 |
| pageSize | 每页几条数据 |
| pageNum | 第几页 |
| nextPage | 下一页的页面序号 |
| total | 据查询数量有多少页 |
| domain | 备案的域名 |
| domainId | 域名id |
| limitAccess | 是否限制接入 |
| mainLicence | ICP备案主体许可证号 |
| natureName | 主办单位性质 |
| serviceLicence | ICP备案服务许可证号 |
| unitName | 主办单位名称 |
| updateRecordTime | 审核通过日期 |
| contentTypeName | 服务前置审批项 |
| cityId | 城市ID |
| countyId | 区县ID |
| contentTypeName | 内容类型 |
| mainUnitAddress | 主体地址 |
| serviceName | 服务名称(APP、小程序或快应用名称) |
| version | 服务版本 |
| blackListLevel | 威胁等级,表示是否为违法违规应用,目前获得的等级为2时,表示暂无违法违规信息 |
🔗 其他资源
⭐ Star History
// faq
What is ICP_Query?
查询域名、APP、小程序、快应用以及企业的ICP备案信息,提供完全本地化的API. It is open-source on GitHub.
Is ICP_Query free to use?
ICP_Query is open-source, so it is free to use.
What category does ICP_Query belong to?
ICP_Query is listed under uncategorized in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/icpquery)
// retro hit counter
[](https://claudeers.com/icpquery)
// reviews
// guestbook
// related in Uncategorized / Others
Reverse engineer anything with agents, from app behavior down to native binaries.
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
The agent engineering platform.
100+ AI Agent & RAG apps you can actually run — clone, customize, ship.