qcc-phone-lookup

企查查号码查企业 — 销售在手机 WorkBuddy 里，发一张带号码的照片/截图或一串号码， 自动查出对应的公司名称 + 统一社会信用代码，并入库 localCRM。

部署指南（WorkBuddy 里操作）

第一步：安装（只做一次）

pip install --upgrade qcc-phone-lookup
playwright install chromium

playwright 已包含在 qcc-phone-lookup 的必装依赖里，会随包一起装上，不用单独 pip install playwright。第一条命令把 Python 包装好，第二条把 Chromium 浏览器二进制下到本地（~/.cache/ms-playwright/）。

手机/Termux 等无显示服务器环境，需要装虚拟显示服务器（企查查登录页会拦截 headless，必须走 headed）：

# Termux（Android）
pkg install -y xvfb

# iSH（iOS Alpine）
apk add xvfb

# Ubuntu/Debian
sudo apt-get install -y xvfb

# 装完验证
qcc-doctor   # 环境体检：playwright / chromium / xvfb / DISPLAY 是否齐全

qcc-doctor 会逐项打印 OK / FAIL 并给出修复命令，缺啥一目了然。

第二步：装技能（只做一次）

把本仓库里的 qcc_phone_lookup/skills/qcc-phone-lookup/SKILL.md 内容发给主智能体， 让它保存为技能目录下的 qcc-phone-lookup/SKILL.md（例如 ~/.workbuddy/skills/qcc-phone-lookup/SKILL.md， 具体路径以 workbuddy 技能目录为准）。

第三步：登录企查查（只做一次）

在 workbuddy 里说：

登录企查查

它会执行 qcc-login-qr 生成二维码（browser_data/qrcode.png）， 把二维码发给你 → 用企查查 App / 微信扫一下 → 告诉它扫完了， 它执行 qcc-login-confirm 保存登录态。看到 登录态已保存 就成功了。

登录态存在当前目录的 browser_data/，workspace 持久，之后不用重复登录（过期再扫一次）。

第四步：日常使用

在钉钉里给机器人：

• 发一张带号码的照片/截图 → 自动识别号码并查询
• 直接发一串号码 → 直接查询

查到后返回公司名称 + 统一社会信用代码，并入库 localCRM。 一个号码对应多家公司时会让你确认是哪一家。

日常操作总结

手动命令参考

qcc-login-qr          # 生成登录二维码（截图即返回，浏览器保持存活）
qcc-login-confirm     # 扫码后确认登录，保存登录态
qcc-lookup 13800138000  # 查询号码对应的企业，输出 JSON
qcc-login             # 一步式登录（= 上面两条合一）
qcc-doctor            # 环境体检（playwright / chromium / xvfb）

注意：所有命令必须在同一个工作目录下执行，登录态在 ./browser_data/。

常见问题

Q: 提示"未找到登录态"？ A: 还没登录或登录过期了，走第三步重新扫码。

Q: 查询返回空结果？ A: 确认号码是纯数字、没打错；再确认登录态没过期。

Q: 登录页返回 405 / 装好之后跑不起来？ A: 先跑 qcc-doctor，它会告诉你缺 playwright / chromium / xvfb 还是 DISPLAY 没设置。按提示装好即可。

Q: xvfb 装哪一版？ A: 各平台包名都是 xvfb（Termux: pkg install xvfb / Ubuntu: apt install xvfb / Alpine: apk add xvfb）。装完用 which xvfb-run 验证。

Q: 不想装 xvfb（纯 headless 模式）？ A: qcc-login --headless 即可跳过虚拟显示，但数据中心 IP 实测会被企查查 405 拦截，本机/家庭 IP 通常没事。

Q: 查询被企查查风控拦截（405）？ A: 查询太频繁了，隔几分钟再试；持续被拦就重新扫码登录。

Q: 换了工作目录就提示没登录？ A: 登录态存在原目录的 browser_data/，回到原目录执行命令即可。

开发者

本地构建：

pip install build
python -m build          # 产出在 dist/
pip install dist/qcc_phone_lookup-0.5.2-py3-none-any.whl

License

MIT