大众点评API

技能标识：dianping-api

Dianping (大众点评) API skill for searching restaurants and businesses, viewing shop details, deals/coupons, and reading recommended dishes. Use this skill when: (1) the user asks about restaurants, food, or local businesses in Chinese cities, (2) the user wants to search dianping.com, (3) the user needs shop ratings, reviews, prices, deals, or addresses from 大众点评, (4) any query involving Chinese dining recommendations or local business lookup.

作者：admin | 来源记录：ClawHub

Dianping API

Zero-dependency HTTP API for dianping.com (大众点评). No browser engine, no pip install — only curl (pre-installed on macOS/Linux).

Prerequisites

- Python 3.6+
INLINECODE1 (系统自带，无需安装)

Authentication (only 2 cookies needed)

Only dper and dplet cookies are required. Stored in ~/.dianping/cookies.json.

CODEBLOCK0

API Reference — `dianping_api.py`

All commands output JSON to stdout, ready for AI parsing.

1. Search Shops

CODEBLOCK1

- keyword: 大众点评搜索框，支持自由组合。示例：

- 菜系: "川菜", "日料", "淮扬菜", "火锅", "西餐" - 地点+菜系: "外滩日料", "陆家嘴火锅", "世纪大道淮扬菜" - 景点+场景: "迪士尼亲子餐厅", "故宫烤鸭", "西湖本帮菜" - 特殊需求: "有包厢", "宝宝餐", "人均100", "深夜食堂" - 综合: "陆家嘴亲子好评", "南京路网红甜品"

- city_id: 城市编号（见下方城市表），默认 1=上海

Response:
CODEBLOCK2

2. Shop Details

CODEBLOCK3

Response:
CODEBLOCK4

3. Deals / Coupons

CODEBLOCK5

Response:
CODEBLOCK6

Python Import Usage

CODEBLOCK7

Typical AI Workflow

CODEBLOCK8

City IDs

城市	ID	城市	ID	城市	ID	城市	ID
上海	1	北京	2	大连	3	广州	4
杭州

5 | 苏州 | 6 | 深圳 | 7 | 成都 | 8 | | 南京 | 9 | 天津 | 10 | 沈阳 | 11 | 武汉 | 12 | | 哈尔滨 | 13 | 长沙 | 14 | 厦门 | 15 | 郑州 | 16 | | 西安 | 17 | 青岛 | 18 | 重庆 | 19 | 昆明 | 20 |

Error Handling

All errors return {"error": "..."}. Common:

- "请求失败或需要重新登录" → Run INLINECODE27

Architecture

- Backend: Pure HTTP via curl subprocess (no Playwright/browser, no pip dependencies)
Auth: dper + dplet cookies in INLINECODE31
Scripts: dianping_login.py (auth管理) + dianping_api.py (数据API)

大众点评API

零依赖的HTTP API，用于访问大众点评。无需浏览器引擎，无需pip安装——只需curl（macOS/Linux系统自带）。

前置条件

- Python 3.6+
curl（系统自带，无需安装）

身份验证（仅需2个Cookie）

仅需dper和dplet两个Cookie。存储在~/.dianping/cookies.json中。

bash

设置Cookie

python3 dianping-api/scripts/dianping_login.py --set-cookies dper=xxx; dplet=yyy

检查登录状态

python3 dianping-api/scripts/dianping_login.py --status

Cookie过期？引导式续期：

python3 dianping-api/scripts/dianping_login.py --renew

API参考 — dianping_api.py

所有命令输出JSON到标准输出，便于AI解析。

1. 搜索店铺

bash
python3 dianping-api/scripts/dianpingapi.py search <关键词> [--cityid N]

- 关键词：大众点评搜索框，支持自由组合。示例：

- 菜系：川菜、日料、淮扬菜、火锅、西餐 - 地点+菜系：外滩日料、陆家嘴火锅、世纪大道淮扬菜 - 景点+场景：迪士尼亲子餐厅、故宫烤鸭、西湖本帮菜 - 特殊需求：有包厢、宝宝餐、人均100、深夜食堂 - 综合：陆家嘴亲子好评、南京路网红甜品

- city_id：城市编号（见下方城市表），默认1=上海

响应：
json
{
keyword: 世纪大道淮扬菜,
city_id: 1,
count: 11,
shops: [
{
shop_id: l7UgWvw6yZ7ytaly,
name: 九厨·淮扬(陆家嘴紫金山店),
rating: 4.5,
review_count: 455,
avg_price: 155
}
]
}

2. 店铺详情

bash
python3 dianping-api/scripts/dianpingapi.py shop id>

响应：
json
{
shop_id: l7UgWvw6yZ7ytaly,
name: 九厨·淮扬(陆家嘴紫金山店),
score_text: 口味:4.7 环境:4.8 服务:4.7,
avg_price: 155,
review_count: 455条,
category: 淮扬菜,
region: 世纪大道,
address: 东方路778号金陵紫金山大酒店2楼,
route: 距地铁世纪大道站12口步行400m,
phone: 65,
recommended_dishes: [九厨桂花香酥烤鸭, 淮安特色一品狮子头, ...],
scores: {taste: 4.7, environment: 4.8, service: 4.7}
}

3. 优惠/团购

bash
python3 dianping-api/scripts/dianpingapi.py deals id>

响应：
json
{
shop_id: l7UgWvw6yZ7ytaly,
name: 九厨·淮扬(陆家嘴紫金山店),
deals: [
{title: 【午市专享】100元代金券, price: 79.0, original_price: 100.0},
{title: 九厨淮扬精选宝宝餐, price: 0.1, original_price: 29.9},
{title: 招牌烤鸭+醉沼虾+牛肉粒2-3人餐, price: 279.0, original_price: 500.0}
],
services: [],
tags: []
}

Python导入使用

python
import sys; sys.path.insert(0, dianping-api/scripts)
from dianpingapi import apisearch, apishop, apideals

搜索
results = apisearch(陆家嘴火锅, cityid=1) for s in results[shops]: print(s[shop_id], s[name], s.get(rating))
店铺详情
info = api_shop(l7UgWvw6yZ7ytaly) print(info[scores], info[recommended_dishes])
优惠
deals = api_deals(l7UgWvw6yZ7ytaly) for d in deals[deals]: print(d[title], d.get(price), d.get(original_price))
典型AI工作流程

1. 根据用户意图组合关键词（地点+菜系+场景），选对city_id
例：用户说北京故宫附近吃烤鸭 → search(故宫烤鸭, city_id=2) 例：用户说上海迪士尼带娃吃饭 → search(迪士尼亲子餐厅, city_id=1) 例：用户说杭州西湖附近日料 → search(西湖日料, city_id=5)
2. apisearch(keyword, cityid) → 获取shopid列表
apishop(shopid) → 评分、推荐菜、地址、交通
apideals(shop_id) → 优惠券、套餐、价格
整理推荐给用户（含评分、人均、推荐菜、优惠信息）

城市编号

城市 ID 城市 ID 城市 ID 城市 ID
上海 1 北京 2 大连 3 广州 4
杭州
5 | 苏州 | 6 | 深圳 | 7 | 成都 | 8 | | 南京 | 9 | 天津 | 10 | 沈阳 | 11 | 武汉 | 12 | | 哈尔滨 | 13 | 长沙 | 14 | 厦门 | 15 | 郑州 | 16 | | 西安 | 17 | 青岛 | 18 | 重庆 | 19 | 昆明 | 20 |
错误处理

所有错误返回{error: ...}。常见情况：

- 请求失败或需要重新登录 → 运行dianping_login.py --renew

架构设计

- 后端：通过curl子进程实现纯HTTP请求（无Playwright/浏览器，无pip依赖）
认证：dper + dplet Cookie存储在~/.dianping/cookies.json
脚本：dianpinglogin.py（认证管理）+ dianpingapi.py（数据API）

大众点评API

大众点评API

Dianping API

Prerequisites

Authentication (only 2 cookies needed)

API Reference — `dianping_api.py`

1. Search Shops

2. Shop Details

3. Deals / Coupons

Python Import Usage

Typical AI Workflow

City IDs

Error Handling

Architecture

大众点评API

前置条件

身份验证（仅需2个Cookie）

设置Cookie

检查登录状态

Cookie过期？引导式续期：

API参考 — dianping_api.py

1. 搜索店铺

2. 店铺详情

3. 优惠/团购

Python导入使用

搜索

店铺详情

优惠

典型AI工作流程

城市编号

错误处理

架构设计

标签

通过对话安装

方式一：安装 SkillHub 和技能

方式二：设置 SkillHub 为优先技能安装源

通过命令行安装

下载

大众点评API

大众点评API

Dianping API

Prerequisites

Authentication (only 2 cookies needed)

API Reference — dianping_api.py

1. Search Shops

2. Shop Details

3. Deals / Coupons

Python Import Usage

Typical AI Workflow

City IDs

Error Handling

Architecture

大众点评API

前置条件

身份验证（仅需2个Cookie）

设置Cookie

检查登录状态

Cookie过期？引导式续期：

API参考 — dianping_api.py

1. 搜索店铺

2. 店铺详情

3. 优惠/团购

Python导入使用

搜索

店铺详情

优惠

典型AI工作流程

城市编号

错误处理

架构设计

标签

通过对话安装

方式一：安装 SkillHub 和技能

方式二：设置 SkillHub 为优先技能安装源

通过命令行安装

下载

相关推荐

self-improvement

self-improvement

self-improvement

self-improvement

API Reference — `dianping_api.py`