| name | travel-destination-ranker |
| description | 旅游目的地热度排行工具。通过爬取马蜂窝景点推荐数据（收藏/点评数）结合高德地图实时搜索/导航量，对多个旅游城市进行综合热度排行。当用户需要：（1）比较多个城市的旅游热度；（2）查询某城市的热门景点排名；（3）获取目的地实时交通拥堵情况时使用。数据来源：马蜂窝（景点热度）、高德地图（搜索量/路况）。触发场景：'帮我比较武汉、成都、重庆哪个更值得去' / '给我推荐一个周末游的城市排行' / '查一下各城市的景点热度排名' |
旅游目的地热度排行技能
通过马蜂窝景点热度 × 高德地图实时流量双数据源，计算城市综合旅游热度排行。
核心算法
综合热度得分 = α × log(景点总热度+1) × 景点数量^0.3
+ β × log(高德搜索量+1)
其中：
景点总热度 = 收藏数×2 + 点评数
α = 0.5（景点热度权重）
β = 0.5（高德流量权重）
脚本说明
| 脚本 | 作用 |
|---|
scripts/mafengwo_scraper.py | 马蜂窝爬虫（城市搜索 + 景点列表） |
scripts/gaode_api.py | 高德地图 API（POI搜索 + 实时路况 + 天气） |
scripts/rank_destinations.py | 综合排行主程序（整合两个数据源） |
使用方法
前提配置
1. 高德地图 Key（必需）
申请地址：https://lbs.amap.com/
免费额度：10000次/天 Web服务 API
设置环境变量：
set GAODE_KEY=你的Key
或直接用 --gaode-key 参数传入。
2. 马蜂窝爬虫（无需 Key，直接可用）
- 无需登录/注册
- 有基础反爬限制，控制请求频率（已内置延迟）
快速开始
python scripts/rank_destinations.py rank `
--cities 武汉,成都,重庆,西安,杭州,南京 `
--gaode-key 你的高德Key `
--pages 2 `
--out result.json `
--report report.md
python scripts/rank_destinations.py analyze `
--city 武汉 `
--gaode-key 你的高德Key
python scripts/mafengwo_scraper.py batch `
--cities 武汉,成都,重庆 `
--pages 2 `
--out attractions.json
python scripts/gaode_api.py batch `
--key 你的高德Key `
--cities 武汉,成都,重庆 `
--keyword 旅游景点 `
--out gaode_search.json
输出示例
排行榜输出（JSON）
{
"rank": 1,
"city": "成都",
"scores": {
"attraction_heat": 45678,
"gaode_search_volume": 123456,
"raw_score": 42.3
},
"attraction": {
"attraction_count": 42,
"total_heat": 45678,
"top_attractions": [
{"name": "宽窄巷子", "score": 4.8, "favs": 2345, "reviews": 890}
]
},
"gaode": {
"total_search_volume": 123456,
"traffic_summary": {"smooth": 12, "slow": 5, "congested": 2}
}
}
Markdown 报告
| 排名 | 城市 | 综合得分 | 景点热度 | 高德搜索量 | 拥堵道路 |
|------|------|----------|----------|------------|---------|
| 1 | 成都 | 42.3 | 45678 | 123456 | 2/19 |
数据来源说明
马蜂窝（景点热度）
- 数据：城市景点列表 + 收藏数 + 点评数 + 评分
- 覆盖：全国主要旅游城市
- 更新周期：每次爬取为实时数据
- 反爬策略：内置随机延迟，自动重试
高德地图（实时流量）
- 搜索量：用
旅游景点 等关键词搜索结果数作为代理指标
- 路况：实时拥堵道路统计（畅通/缓行/拥堵）
- 注意：高德不直接提供"导航次数"数据，搜索量是近似替代
限制与注意事项
- 高德 API Key：必须有效 Key 才能调用成功
- 马蜂窝反爬：每次请求间隔 1-2 秒，大规模抓取可能被封 IP
- 数据完整性：马蜂窝页面结构可能变化，解析逻辑需要定期维护
- 搜索量代理：高德搜索结果数 ≠ 实际导航次数，存在偏差
- 权重可调：WEIGHT_CONFIG 中 alpha/beta 可根据实际效果调整
文件结构
travel-destination-ranker/
├── SKILL.md
├── scripts/
│ ├── mafengwo_scraper.py # 马蜂窝爬虫
│ ├── gaode_api.py # 高德 API 调用
│ └── rank_destinations.py # 综合排行主程序
└── references/
└── city_ids.json # 常用城市 ID 映射（可选）
