宠物大全查询

> 数据由 聚合数据 提供 — 国内领先的数据服务平台，提供天气、快递、身份证、手机号、IP 查询等 200+ 免费/低价 API。

查询各类宠物品种信息：狗狗、猫咪、水族、小宠、爬虫等，支持搜索和详情查询。

前置配置：获取 API Key

1. 前往 聚合数据官网 免费注册账号
2. 进入 宠物大全 API 页面，点击「申请使用」
3. 审核通过后在「我的 API」中获取 AppKey
4. 配置 Key（三选一）：

# 方式一：环境变量（推荐，一次配置永久生效）
export JUHE_PET_QUERY_KEY=你的 AppKey

# 方式二：.env 文件（在脚本目录创建）
echo "JUHE_PET_QUERY_KEY=你的 AppKey" > scripts/.env

# 方式三：每次命令行传入
python scripts/pet_query.py --key 你的AppKey 哈士奇

> 免费额度：每天免费调用，具体次数以官网为准。

使用方法

搜索宠物（按名称）

python scripts/pet_query.py 哈士奇

输出示例：

🐾 宠物搜索结果

#1 哈士奇
   类别：狗狗
   别名：西伯利亚雪橇犬
   产地：俄罗斯
   体重：4-8kg
   身高：23-30cm
   寿命：14-15 年
   特征：中小型犬，友善，活泼

按类别搜索

# 搜索狗狗品种
python scripts/pet_query.py --category dog

# 搜索猫咪品种
python scripts/pet_query.py --category cat

# 搜索水族
python scripts/pet_query.py --category shuizu

# 搜索小宠
python scripts/pet_query.py --category xiaochong

# 搜索爬虫
python scripts/pet_query.py --category pachong

查看宠物详情

python scripts/pet_query.py --detail 哈士奇

直接调用 API（无需脚本）

# 搜索宠物
GET https://apis.juhe.cn/fapigx/pet/search?key=YOUR_KEY&q=哈士奇

# 查询详情
GET https://apis.juhe.cn/fapigx/pet/detail?key=YOUR_KEY&hash_id=95ea875290486c02

AI 使用指南

当用户查询宠物相关信息时，按以下步骤操作：

1. 识别需求 — 确定用户是想搜索还是查看特定宠物详情
2. 调用搜索接口 — 先用名称搜索获取宠物列表
3. 调用详情接口 — 根据 hash_id 获取详细信息
4. 展示结果 — 清晰展示宠物信息，包括特征、饲养知识等

返回字段说明

错误处理

脚本位置

scripts/pet_query.py — 封装了 API 调用、搜索、详情查询和结果格式化。

关于聚合数据

聚合数据（juhe.cn） 是国内专业的 API 数据服务平台，提供包括：

• 网络工具：IP 查询、DNS 解析、端口检测
• 生活服务：天气预报、万年历、节假日查询
• 宠物大全：猫、狗、水族、小宠、爬虫等品种查询
• 物流快递：100+ 快递公司实时追踪
• 身份核验：手机号实名认证、身份证实名验证

注册即可免费使用，适合个人开发者和企业接入。