apihz-cli
Command-line interface for apihz.cn — 接口盒子, 479+ APIs at your terminal.

Installation
For Humans
Copy and paste this prompt to your LLM agent (Claude Code, Cursor, Codex, etc.):
Install and configure apihz-cli by following the instructions here:
https://raw.githubusercontent.com/mack-peng/apihz-cli/main/docs/guide/installation.md
Or read the Installation Guide, but seriously, let an agent do it. Humans fat-finger configs.
For LLM Agents
Fetch the installation guide and follow it:
curl -s https://raw.githubusercontent.com/mack-peng/apihz-cli/main/docs/guide/installation.md
Quick Start
Install
npm install -g @orangemust/apihz-cli
1. Get API Credentials
Register at apihz.cn to get your Developer ID and KEY (User Center → 开发信息).
2. Configure
apihz-cli config set --id=10016043 --key=xxxxxxxx
3. Try It
apihz-cli time now --type=20
apihz-cli ip lookup
apihz-cli text yiyan
apihz-cli news baidu
Configuration
apihz-cli config set --id=<id> --key=<key>
apihz-cli config set --vip
apihz-cli config show
apihz-cli config get id
apihz-cli config reset
apihz-cli config path
Priority: CLI flags > Environment variables > Config file (~/.apihz/config.json)
APIHZ_ID | Developer ID |
APIHZ_KEY | Developer KEY |
APIHZ_VIP | Set to 1 for VIP line |
Global Options
--id <id> Developer ID (overrides config and env)
--key <key> Developer KEY (overrides config and env)
--vip Use VIP line (https://vip.apihz.cn)
--raw Output raw API response without formatting
Commands
Time (时间)
apihz-cli time now --type=20
apihz-cli time to-timestamp --time="2024-03-20 16:16:16"
apihz-cli time from-timestamp --time=1710925735 --type=1
apihz-cli time calendar
apihz-cli time country --country=US
Weather (天气)
apihz-cli weather by-address --place=绵阳 --sheng=四川 --day=3
apihz-cli weather by-ip --day=1 --hourtype=1
apihz-cli weather by-coords --lon=116.30 --lat=40.05
apihz-cli weather moji15 --sheng=四川 --place=绵阳
apihz-cli weather cloud
apihz-cli weather precipitation
apihz-cli weather temp-anomaly
apihz-cli weather humidity
IP & Location (位置坐标)
apihz-cli ip lookup
apihz-cli ip lookup --ip=112.192.49.243
apihz-cli ip visitor
apihz-cli phone lookup --phone=13219931963
apihz-cli region list --type=1
apihz-cli region list --type=2 --sheng=四川
apihz-cli region code --sheng=四川 --place=绵阳
apihz-cli region country
apihz-cli idcard lookup --card=510704888888888888
apihz-cli geo reverse --lon=116.30 --lat=40.05
Image (图像)
apihz-cli image memes --words=开心 --source=apihz
apihz-cli image search --words=风景 --source=baidu
apihz-cli image wallpaper --type=1
apihz-cli image avatar --type=5
apihz-cli image bing
apihz-cli image nasa --hd
Text & Dictionary (字词句名)
apihz-cli text translate --words="你好" --from=2 --to=1
apihz-cli text yiyan
apihz-cli text yiyan-search --words=人生
apihz-cli text pinyin --words="接口盒子"
apihz-cli text hanzi --word=天
apihz-cli text ciyu --words=宇宙
apihz-cli text baike --words=北京
apihz-cli text nick --min=2 --max=6
apihz-cli text case --type=1 --words="hello"
apihz-cli text jfzh --type=1 --words="接口盒子"
apihz-cli text today
apihz-cli text joke
Idioms (成语)
apihz-cli chengyu random
apihz-cli chengyu chain --word=天
apihz-cli chengyu lookup --words=焕然一新
QR Code (二维码)
apihz-cli qrcode create --text="hello"
apihz-cli qrcode parse --type=1 --img=<url>
apihz-cli qrcode parse-plus --type=1 --img=<url>
News (新闻热点)
apihz-cli news baidu
apihz-cli news weibo
apihz-cli news douyin
Network (域名网站)
apihz-cli network icp --domain=apihz.cn
apihz-cli network icp-plus --domain=apihz.cn
apihz-cli network domain --domain=example.com
apihz-cli network tdk --url=https://www.apihz.cn
AI Recognition (AI识别) — PAID
apihz-cli ai face-compare --type=1 --imga=<url1> --imgb=<url2>
apihz-cli ai face-liveness --type=1 --img=<url>
apihz-cli ai face-attr --type=1 --img=<url> --mode=1
apihz-cli ai ocr --type=1 --img=<url>
apihz-cli ai idcard --type=1 --img=<url>
apihz-cli ai bankcard --type=1 --img=<url>
apihz-cli ai driving-license --type=1 --img=<url>
apihz-cli ai vehicle-license --type=1 --img=<url> --page=1
apihz-cli ai business-license --type=1 --img=<url>
apihz-cli ai receipt --type=1 --img=<url>
apihz-cli ai plate --type=1 --img=<url>
apihz-cli ai vehicle --type=1 --img=<url>
apihz-cli ai product --type=1 --img=<url>
apihz-cli ai tag --type=1 --img=<url>
Voice (语音) — PAID
apihz-cli voice to-text --type=1 --data=<url> --format=wav
apihz-cli voice to-voice --text="你好" --type=1 --voice=1001
Auth (实名认证) — PAID
apihz-cli auth bank3 --name=张三 --number=6222... --idcard=5107...
apihz-cli auth bank2 --name=张三 --number=6222...
apihz-cli auth alipay --name=张三 --number=5107...
apihz-cli auth alipay-check --cxid=xxxx
Storage (存储)
apihz-cli storage text --type=2 --numid=1
apihz-cli storage text --type=1 --numid=1 --words="hello" --title="test"
apihz-cli storage data-create --name=data1,data2 --data="val1","val2"
apihz-cli storage data-query --name=* --page=1 --limit=10
SMS (短信)
apihz-cli sms send --phone=13219931963
apihz-cli sms send-verify --type=1 --phone=13219931963
apihz-cli sms send-verify --type=2 --phone=13219931963 --code=123456
apihz-cli sms send-aliyun --phone=13219931963 --aliid=... --alikey=... --sign=... --template=... --code=123456
Unit Conversion (单位换算)
apihz-cli unit speed --num=100 --unit=米秒
apihz-cli unit time --num=3600 --unit=秒
apihz-cli unit density --num=1 --unit=千克立方米
apihz-cli unit frequency --num=1000 --unit=赫兹
apihz-cli unit current --num=5 --unit=安培
apihz-cli unit voltage --num=220 --unit=伏特
apihz-cli unit resistance --num=1000 --unit=欧姆
Misc (杂项)
apihz-cli misc jiakao --type=1
apihz-cli misc qq --qq=10001
apihz-cli misc lottery
apihz-cli misc lanzou --url=<share_link> --pwd=6pvs
apihz-cli misc phone-status --number=13219931963
apihz-cli misc phone-online --number=13219931963
apihz-cli misc bank-info --number=6222...
apihz-cli misc chem-eq --reactants=H2,O2 --products=H2O
apihz-cli misc element --name=H
apihz-cli misc mail --name=... --to=... --title=... --text=... (etc.)
apihz-cli misc proxy --type=1
apihz-cli misc redpack --zfb=account --name=张三
Development
npm install
npm run build
npm run watch
License
MIT