宠物大全查询#

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

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

---

前置配置：获取 API Key#

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

bash

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

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

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

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

---

使用方法#

搜索宠物（按名称）#

bash

python scripts/pet_query.py 哈士奇

输出示例：

text

🐾 宠物搜索结果

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

按类别搜索#

bash

# 搜索狗狗品种
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

查看宠物详情#

bash

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

直接调用 API（无需脚本）#

text

# 搜索宠物
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. 展示结果 — 清晰展示宠物信息，包括特征、饲养知识等

返回字段说明#

字段含义示例name宠物名称哈士奇alias别名西伯利亚雪橇犬category类别dog/cat/shuizi/xiaochong/pachongorigin原产地俄罗斯weight体重4-8kgheight身高23-30cmlife_span寿命14-15 年fur_color毛色黑白色functions用途伴侣犬introduction介绍详细介绍...history历史品种历史...care_knowledge饲养知识饲养要点...common_diseases常见疾病疾病预防...fur_care毛发护理护理方法...

错误处理#

情况处理方式error_code 10001/10002API Key 无效，引导用户至 聚合数据 重新申请error_code 10012当日免费次数已用尽，建议升级套餐参数错误参数错误，检查参数格式无搜索结果告知用户未找到相关宠物，建议更换搜索词

---

脚本位置#

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

---

关于聚合数据#

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

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

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