活动运营与二维码物料 Skill

面向活动运营、二维码物料、线下推广、门店活动和扫码复核的公开 API 组合。

业务场景

用于活动运营、二维码物料、线下推广、门店活动、扫码复核和活动排期。适合把二维码、Wi-Fi 码、条形码、二维码解析、图片压缩、URL 截图、HTML/PDF 转换、天气、农历、日出日落、正文图片和号码归属组合成活动执行链路。

• 数据范围：覆盖二维码、Wi-Fi 二维码、条形码、二维码解析、图片压缩、URL 截图、HTML 转 PDF、Markdown 转 PDF、天气、农历节气、日出日落、正文图片和手机归属地。
• 关键数据维度：活动维度：活动 URL、城市、日期、报名页、门店和联系人号码。；物料维度：二维码内容、条码类型、海报 HTML、Markdown、PDF、截图和图片大小。；执行维度：天气、农历、日出日落、投放渠道和扫码复核结果。

何时使用

• 为活动页、报名页、门店 Wi-Fi 和商品信息生成二维码或条形码。
• 把活动页面、Markdown 或 HTML 转成 PDF、截图和压缩图片物料。
• 结合城市、日期、天气和日历数据做线下活动提醒。

不适用场景

• 用户只需要查看某一个接口的完整参数、响应字段、价格或购买入口时，直接打开接口详情页。
• 用户希望绕过接口开通、鉴权、配额或人工复核要求时，不应使用 Skill 作为替代。
• 任务需要法律、医疗、金融投资或升学录取的最终决策时，Skill 只能提供数据辅助和复核线索。

用户需要提供的信息

• 活动 URL、报名页、门店 Wi-Fi 信息、条码内容、海报 HTML/Markdown、活动城市、日期和素材图片。
• 输出目标：二维码、Wi-Fi 码、条形码、PDF 物料、图片压缩、活动日期提醒或扫码复核。
• 调用接口所需的 AppKey、开通状态和接口详情页限制。

推荐工作流

1. 先根据活动链接、Wi-Fi 信息或条码内容生成二维码和条形码。
2. 再把活动页面、HTML 或 Markdown 转成截图、PDF 和压缩图片物料。
3. 最后结合天气、农历和日出日落做线下执行提醒，并用二维码解析复核投放内容。

参数传递关系

• 活动链接、门店 Wi-Fi 或条码内容先生成二维码/条码，再把生成结果用于海报、PDF 或线下物料。
• 海报页面可用 URL 截图、HTML 转 PDF 或 Markdown 转 PDF 生成可分发物料。
• 城市和日期传给天气、农历和日出日落接口，用于活动时间和线下执行提醒。
• 二维码解析接口用于投放前复核，解析出的 URL 需要再检查跳转和内容安全。

典型任务模板

• 线下活动包：输入活动 URL、城市和日期；输出二维码、PDF 海报、天气提醒和投放复核清单。
• 门店物料：输入 Wi-Fi 信息、门店页和条码内容；输出 Wi-Fi 码、页面截图、条码和压缩图片。
• 扫码复核：输入已投放二维码图片；输出解析内容、目标 URL、风险提示和修正建议。

接口与关键参数

统一鉴权：调用接口前需要准备咕咕数据 AppKey。AppKey 应从环境变量或凭据管理系统注入，不要写入 SKILL.md、代码仓库、URL、日志或对话正文。推荐在服务端通过 Header 传递 AppKey；历史 Query 参数 appkey 仍以接口详情页说明为准。

通用二维码生成

• 业务角色：二维码生成
• 调用阶段：物料生成
• 接口地址：GET https://api.gugudata.com/barcode/qrcode
• 产出用途：用于活动页或报名页二维码。
• 参数来源：文本内容来自用户输入、网页正文抽取或文档识别结果
• 接口资料：详情页 https://www.gugudata.com/api/details/qrcode；接口 Markdown https://www.gugudata.com/api/details/qrcode/llm.md

关键请求参数：

Wi-Fi 无线网二维码生成

• 业务角色：Wi-Fi 二维码
• 调用阶段：物料生成
• 接口地址：GET https://api.gugudata.com/barcode/wifiqrcode
• 产出用途：用于门店 Wi-Fi 二维码。
• 参数来源：由用户输入、业务筛选条件或上一轮接口结果确定
• 接口资料：详情页 https://www.gugudata.com/api/details/wifiqrcode；接口 Markdown https://www.gugudata.com/api/details/wifiqrcode/llm.md

关键请求参数：

通用条形码生成

• 业务角色：条形码生成
• 调用阶段：物料生成
• 接口地址：GET https://api.gugudata.com/barcode/barcode
• 产出用途：用于生成通用条形码。
• 参数来源：文本内容来自用户输入、网页正文抽取或文档识别结果
• 接口资料：详情页 https://www.gugudata.com/api/details/barcode；接口 Markdown https://www.gugudata.com/api/details/barcode/llm.md

关键请求参数：

通用二维码解析读取

• 业务角色：二维码解析
• 调用阶段：投放复核
• 接口地址：POST https://api.gugudata.com/barcode/qrcode/decode
• 产出用途：用于投放前解析复核。
• 参数来源：文件或图片来自用户上传、公开 URL 或上一轮转换结果
• 接口资料：详情页 https://www.gugudata.com/api/details/qrcode-decode；接口 Markdown https://www.gugudata.com/api/details/qrcode-decode/llm.md

关键请求参数：

图片压缩与尺寸优化

• 业务角色：图片压缩
• 调用阶段：图片处理
• 接口地址：POST https://api.gugudata.com/ai/image-compress
• 产出用途：用于压缩活动图片。
• 参数来源：文件或图片来自用户上传、公开 URL 或上一轮转换结果；URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性
• 接口资料：详情页 https://www.gugudata.com/api/details/image-compress；接口 Markdown https://www.gugudata.com/api/details/image-compress/llm.md

关键请求参数：

URL 生成网站截图

• 业务角色：URL 截图
• 调用阶段：物料输出
• 接口地址：GET https://api.gugudata.com/websitetools/url2image
• 产出用途：用于生成活动页截图。
• 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性；号码来自用户输入、表单线索或上一轮内容抽取结果
• 接口资料：详情页 https://www.gugudata.com/api/details/url2image；接口 Markdown https://www.gugudata.com/api/details/url2image/llm.md

关键请求参数：

HTML/URL 转 PDF

• 业务角色：HTML 转 PDF
• 调用阶段：物料输出
• 接口地址：POST https://api.gugudata.com/imagerecognition/html2pdf
• 产出用途：用于生成 PDF 海报或物料。
• 参数来源：文本内容来自用户输入、网页正文抽取或文档识别结果；文件或图片来自用户上传、公开 URL 或上一轮转换结果
• 接口资料：详情页 https://www.gugudata.com/api/details/html2pdf；接口 Markdown https://www.gugudata.com/api/details/html2pdf/llm.md

关键请求参数：

Markdown 转 PDF

• 业务角色：Markdown 转 PDF
• 调用阶段：物料输出
• 接口地址：POST https://api.gugudata.com/imagerecognition/markdown2pdf
• 产出用途：用于把活动文案生成 PDF。
• 参数来源：文本内容来自用户输入、网页正文抽取或文档识别结果
• 接口资料：详情页 https://www.gugudata.com/api/details/markdown2pdf；接口 Markdown https://www.gugudata.com/api/details/markdown2pdf/llm.md

关键请求参数：

全球天气预报信息

• 业务角色：天气预报
• 调用阶段：执行提醒
• 接口地址：GET https://api.gugudata.com/weather/weatherinfo
• 产出用途：用于活动天气提醒。
• 参数来源：时间参数来自用户指定日期、业务统计周期或接口支持的历史范围
• 接口资料：详情页 https://www.gugudata.com/api/details/weatherinfo；接口 Markdown https://www.gugudata.com/api/details/weatherinfo/llm.md

关键请求参数：

农历与二十四节气

• 业务角色：农历节气
• 调用阶段：执行提醒
• 接口地址：GET https://api.gugudata.com/weather/lunarcalendar
• 产出用途：用于活动日历上下文。
• 参数来源：时间参数来自用户指定日期、业务统计周期或接口支持的历史范围
• 接口资料：详情页 https://www.gugudata.com/api/details/lunarcalendar；接口 Markdown https://www.gugudata.com/api/details/lunarcalendar/llm.md

关键请求参数：

日出与日落时间

• 业务角色：日出日落
• 调用阶段：执行提醒
• 接口地址：GET https://api.gugudata.com/weather/sunriseandsunset
• 产出用途：用于线下活动时间安排。
• 参数来源：地区参数来自用户输入、行政区划查询结果或定位结果；时间参数来自用户指定日期、业务统计周期或接口支持的历史范围
• 接口资料：详情页 https://www.gugudata.com/api/details/sunrisesunset；接口 Markdown https://www.gugudata.com/api/details/sunrisesunset/llm.md

关键请求参数：

获取任意链接正文图片

• 业务角色：正文图片
• 调用阶段：素材整理
• 接口地址：POST https://api.gugudata.com/news/fetchcontentimages
• 产出用途：用于获取活动或文章图片素材。
• 参数来源：URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性；文件或图片来自用户上传、公开 URL 或上一轮转换结果；文本内容来自用户输入、网页正文抽取或文档识别结果
• 接口资料：详情页 https://www.gugudata.com/api/details/fetchcontentimages；接口 Markdown https://www.gugudata.com/api/details/fetchcontentimages/llm.md

关键请求参数：

手机归属地查询

• 业务角色：手机归属地
• 调用阶段：线索辅助
• 接口地址：GET https://api.gugudata.com/sms/mobileattribution
• 产出用途：用于活动线索地区辅助判断。
• 参数来源：号码来自用户输入、表单线索或上一轮内容抽取结果
• 接口资料：详情页 https://www.gugudata.com/api/details/mobileattribution；接口 Markdown https://www.gugudata.com/api/details/mobileattribution/llm.md

关键请求参数：

失败处理与恢复

• 缺少必填输入或数据口径不明确时，停止调用并先向用户补齐信息。
• 收到 401 或 403 时，检查 AppKey、安全配置和服务权限；不要在输出中回显凭据。
• 收到 429 时，遵守接口返回的限流提示，降低频率后再试，不要并发放大请求。
• 遇到网络或 5xx 异常时，只对幂等请求进行有限次数重试，并记录失败接口与时间。
• 数据为空或多接口结果冲突时，返回已确认事实、证据缺口和复核建议，不要臆造结论。

数据校验与使用边界

• 二维码投放前必须解析复核，避免错误链接或过期活动页。
• 天气和日历数据只作活动提醒，极端天气需以官方预警为准。
• 物料转换效果受 HTML、字体、图片和页面加载影响。

输出建议

• 输出活动包时列出二维码、PDF、截图、压缩图、日期天气和复核结果。
• 扫码复核应展示解析内容、目标 URL 和风险提示。
• 对失败的物料生成任务给出输入问题和重试建议。

常见问题

• 问：什么情况下应该使用这个 Skill？ 答：当用户提出的目标需要多个咕咕数据公开 API 组合完成，而不是只查询一个接口时，优先阅读这个 Skill。
• 问：这个 Skill 是否需要单独购买？ 答：不需要。Skill 文档只负责业务流程和接口选型，具体接口购买、价格和账号权益仍以接口详情页为准。
• 问：Agent 应该怎样使用这个 Skill？ 答：Agent 应先阅读 SKILL.md，确认业务场景和推荐工作流，再进入接口详情页核对参数、响应字段、价格和调用示例。
• 问：调用接口前需要先核对什么？ 答：需要核对业务对象、地区、时间范围、输入格式、必填参数、返回字段、购买状态和接口详情页中的限制说明。
• 问：活动运营与二维码物料 Skill 会替代接口文档吗？ 答：不会。Skill 负责说明业务组合和调用顺序，接口参数、响应结构、计费和购买入口仍以接口详情页为准。