Agent Skills
返回列表
汇客云客流查询

汇客云客流查询

数据分析 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_4823f79d/huikeyun-passenger-flow

技能介绍

客流查询为什么会这么麻烦

汇客云的接口覆盖了多个场景，V4 和 V5 的方法名、参数格式和返回结构各不相同。getDataByDataRange 和 getDataByModifyTime 看似相似，但调用方需要自己处理阿里云签名、Content-MD5 校验和分页逻辑。每个项目还有自己的凭据和场所标识，手动拼装请求不仅耗时，而且容易在凭据泄漏后引发安全问题。当需要同时查看进出客流、过店客流和游逛时长时，工程师需要在多个脚本之间来回切换，输出格式也各不相同。

这个技能做了什么

该技能把汇客云的查询能力封装成一组可以直接对话调用的端点。客户端脚本 scripts/huikeyun_client.py 负责阿里云签名、Content-MD5 校验和游标分页，调用方只需要指定 endpoint 和参数。当前已抽象出四个端点：traffic 用于按时间戳增量查询进出客流，traffic_range 用于按日期范围查询，through_traffic 提供店铺级过店数据，sites 返回场所列表。

底层返回的 JSON 还可以通过 scripts/query_traffic.py 导出为 CSV，或通过 scripts/export_excel.py 生成包含明细、项目汇总和日期趋势的 Excel 报表。凭据已经内置在 references/config.yaml 中，陆悦天地项目可以直接使用。日常查询不需要编写任何代码，直接在对话中提问即可。

适用边界与注意点

内置凭据仅限内部项目使用，不要复制到公开仓库。如果汇客云调整了返回字段或接口路径，只需要更新 references/config.yaml，不需要修改脚本逻辑。如果新增了接口，可以在 endpoints 下追加配置，然后通过 --endpoint 参数切换。当前依赖 requests、openpyxl 和 pyyaml 三个库，建议固定版本。过店客流和游逛时长依赖 V5 接口，如果目标项目尚未开通 V5，则只能查询进出客流。该技能适合单个项目的日常分析，不适合跨项目复用凭据或做批量监控。

使用场景

  • 商场运营人员需要在周一晨会上汇报上周全场的进出客流趋势，直接通过对话生成包含日期趋势的Excel报表。
  • 品牌方想了解自家门店的过店客流转化情况，使用该技能按小时粒度查询具体店铺的经过客流数据。
  • 数据分析师需要提取特定时间段内的全场顾客去重人数与平均游逛时长，并直接导出为CSV文件用于后续建模。
  • 项目总监需要快速获取陆悦天地各楼层的客流时段分布情况，通过自然语言提问直接在对话中查看JSON结果。

适合人员

  • 商业地产运营专员，需要定期生成客流数据报表并向管理层汇报项目运营状况。
  • 连锁品牌店长，希望快速获取自家门店的过店客流数据以评估橱窗展示效果。
  • 数据分析师，需要提取去重客流和游逛时长等明细数据进行消费者行为建模。
  • 商场企划主管，需要基于全场客流时段分布数据来策划和调整营销活动时间。