---
name: event-campaign-ops
description: "当用户需要使用咕咕数据公开 API 完成活动物料生成、业务数据组合、参数传递、接口选型或结果校验时使用；不适用于绕过接口详情页、购买规则或人工复核要求的场景。"
---

# 活动运营与二维码物料 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。推荐在服务端通过 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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `content` | 是 | `string` | YOUR_VALUE | 二维码内容，网址类型智能识别 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
| `size` | 否 | `integer` | 500 | 正整数，二维码尺寸像素，默认为 500 像素 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `ssid` | 是 | `string` | YOUR_VALUE | 无线网 ssid | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `password` | 是 | `string` | YOUR_VALUE | 无线网密码 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `authentication` | 是 | `string` | YOUR_VALUE | 无线网加密类型，可选 WEP、WPA、NOPASS | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `ishiddenssid` | 是 | `string` | YOUR_VALUE | 是否隐藏 SSID，可选值 true、false | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `isshowwifiicon` | 是 | `string` | YOUR_VALUE | 二维码中间是否添加 Wi-Fi 图标，可选值 true、false | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `size` | 否 | `integer` | 500 | 正整数，二维码尺寸像素，默认为 500 像素 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 通用条形码生成

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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `type` | 是 | `string` | YOUR_VALUE | 条码类型，可选项: UNSPECIFIED\|UPCA\|UPCE\|UPC_SUPPLEMENTAL_2DIGIT\|UPC_SUPPLEMENTAL_5DIGIT\|EAN13\|EAN8\|Interleaved2of5\|Interleaved2of5_Mod10\|Standard2of5\|Standard2of5_Mod10\|Industrial2of5\|Industrial2of5_Mod10\|CODE39\|CODE39Extended\|CODE39_Mod43\|Codabar\|PostNet\|BOOKLAND\|ISBN\|JAN13\|MSI_Mod10\|MSI_2Mod10\|MSI_Mod11\|MSI_Mod11_Mod10\|Modified_Plessey\|CODE11\|USD8\|UCC12\|UCC13\|LOGMARS\|CODE128\|CODE128A\|CODE128B\|CODE128C\|ITF14\|CODE93\|TELEPEN\|FIM\|PHARMACODE | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `content` | 是 | `string` | YOUR_VALUE | 条码内容，注意对应条码的长度规范 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
| `width` | 是 | `integer` | YOUR_VALUE | 条码宽度像素值 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `height` | 是 | `integer` | YOUR_VALUE | 条码高度像素值 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `showLabel` | 否 | `boolean` | false | 控制是否显示条码底部的文字标签，默认不显示，需要显示传递 true | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 通用二维码解析读取

- 业务角色：二维码解析
- 调用阶段：投放复核
- 接口地址：`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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `file` | 是 | `string/binary` | YOUR_FILE | 要解码的二维码图片文件 | 文件或图片来自用户上传、公开 URL 或上一轮转换结果 |

### 图片压缩与尺寸优化

- 业务角色：图片压缩
- 调用阶段：图片处理
- 接口地址：`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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `image_file` | 否 | `string/binary` | - | 上传的图片文件，支持 JPG / JPEG / PNG / GIF / WEBP / BMP，与 image_url 二选一必填 | 文件或图片来自用户上传、公开 URL 或上一轮转换结果 |
| `image_url` | 否 | `string` | - | 网络图片 URL，与 image_file 二选一必填，需为可直接访问的 HTTP/HTTPS 链接 | URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性 |
| `targetWidth` | 否 | `integer` | - | 目标宽度（像素），与 targetHeight 组合使用时按照最长边等比缩放；不传则不以此为约束 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `targetHeight` | 否 | `integer` | - | 目标高度（像素），与 targetWidth 组合使用时按照最长边等比缩放；不传则不以此为约束 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `maxWidth` | 否 | `integer` | - | 最大宽度（像素），只限制不超过该宽度并保持长宽比；当未显式传递任何尺寸参数且图片特别大时，服务会自动使用 1920 作为默认上限 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `maxHeight` | 否 | `integer` | - | 最大高度（像素），只限制不超过该高度并保持长宽比；当未显式传递任何尺寸参数且图片特别大时，服务会自动使用 1920 作为默认上限 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `quality` | 否 | `integer` | 85 | JPEG 压缩质量，取值范围 1-95，数值越低压缩越厉害，推荐在 60-90 之间；PNG 等无损格式将使用内部优化策略忽略该参数 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `format` | 否 | `string` | - | 输出图片格式，可选值：jpeg、png 等；不传则保持原图格式（对于部分不常见格式会自动转换为 JPEG） | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `url` | 是 | `string` | YOUR_VALUE | 需要截取的网页 URL 地址 | URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性 |
| `width` | 否 | `integer` | 250 | 输出截图的宽度，默认值为 250 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `height` | 否 | `integer` | 250 | 输出截图的高度，默认值为 250 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `viewportWidth` | 否 | `integer` | 1080 | 渲染视窗的宽度，默认值为 1080 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `viewportHeight` | 否 | `integer` | 1080 | 渲染视窗的高度，默认值为 1080 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `forceReload` | 否 | `boolean` | false | 强制重新加载已保存的图片，默认值为 false | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `isMobile` | 否 | `boolean` | false | 是否以移动设备的 User Agent 渲染，默认值为 false | 号码来自用户输入、表单线索或上一轮内容抽取结果 |
| `isFullPage` | 否 | `boolean` | false | 是否截取整个页面而非视窗裁剪，默认值为 false | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `isDarkMode` | 否 | `boolean` | false | 是否优先采用深色模式，默认值为 false | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `type` | 是 | `string` | YOUR_VALUE | 可选参数为 HTML 或 URL（注意，当类型为 URL 时，需要保证页面可以正常请求，我们的接口不解决加密页面、反爬虫页面等不能正常返回 HTML 的页面请求） | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `content` | 是 | `string` | YOUR_VALUE | 内容正文，如果 type=HTML，那么传递 HTML 内容；如果 type=URL，那么传递需要存储为 PDF 的站点 URL 即可 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
| `landscape` | 否 | `integer` | 0 | 控制生成 PDF 是否为横向页面模式，传递 1 控制页面横向渲染模式，默认为 0 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `showpages` | 否 | `integer` | 0 | 控制生成的 PDF 是否在页脚包含页码信息，传递 1 控制页脚生成页码，默认为 0 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `filename` | 否 | `string` | N/A | 可选参数，控制生成的文件名称，不需要后缀 | 文件或图片来自用户上传、公开 URL 或上一轮转换结果 |
| `storage` | 否 | `string` | public | 文件存储方式，可选 public 或 private。默认 public 返回公开下载地址；private 存入私有存储，返回 file_id，需生成短期下载链接后下载。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `content` | 是 | `string` | YOUR_VALUE | Markdown 内容 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |
| `storage` | 否 | `string` | public | 文件存储方式，可选 public 或 private。默认 public 返回公开下载地址；private 存入私有存储，返回 file_id，需生成短期下载链接后下载。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |

### 全国天气预报信息

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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `code` | 是 | `string` | YOUR_VALUE | 地区编码，可通过前置接口查询获得地区编码。 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `days` | 否 | `integer` | 1 | 获取天气预报的天数，默认为1，即为当天数据。最大值为7。 | 时间参数来自用户指定日期、业务统计周期或接口支持的历史范围 |

### 农历与二十四节气

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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `date` | 是 | `string` | YOUR_VALUE | 请求转换的日期，格式为: yyyymmdd，如 20220101 | 时间参数来自用户指定日期、业务统计周期或接口支持的历史范围 |

### 日出与日落时间

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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `city` | 是 | `string` | YOUR_VALUE | 查询城市名，如北京、南京、保定等 | 地区参数来自用户输入、行政区划查询结果或定位结果 |
| `date` | 是 | `string` | YOUR_VALUE | 查询的日期，格式为 yyyymmdd，如 20220701 | 时间参数来自用户指定日期、业务统计周期或接口支持的历史范围 |

### 获取任意链接正文图片

- 业务角色：正文图片
- 调用阶段：素材整理
- 接口地址：`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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `url` | 是 | `string` | YOUR_VALUE | 需要抓取正文的文章链接 | URL 或域名由用户提供，调用前需要确认协议、跳转和可访问性 |
| `limittype` | 否 | `string` | YOUR_VALUE | 对图片大小进行筛选条件类型，参数值为 size 或 ratio。size：按照图片大小 (KB) 进行筛选，ratio：按照图片分辨率 [宽,高] 进行筛选 | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `limitvalue` | 否 | `float / [int,int]` | YOUR_VALUE | 对图片大小进行筛选条件值，如果类型为 size，参数值格式为 float 类型的图片最小限制值（单位为 KB），如果类型为 ratio，参数值格式为 int 数组 [宽,高]，分别限制最小宽与高（单位为像素） | 由用户输入、业务筛选条件或上一轮接口结果确定。 |
| `imagewithtag` | 否 | `boolean` | false | 是否返回获取到的图片原始 img HTML 标签 | 文件或图片来自用户上传、公开 URL 或上一轮转换结果 |
| `htmlsourcecontent` | 否 | `boolean` | false | 是否返回文章页面原始 HTML 内容，供您二次解析或分析正文图片列表失败时使用，需要注意接口的性能问题 | 文本内容来自用户输入、网页正文抽取或文档识别结果 |

### 手机归属地查询

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

关键请求参数：

| 参数 | 必填 | 类型 | 默认值 | 说明 | 来源与传递 |
| --- | --- | --- | --- | --- | --- |
| `mobile` | 是 | `string` | YOUR_VALUE | 查询的手机号码 | 号码来自用户输入、表单线索或上一轮内容抽取结果 |

## 数据校验与使用边界

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

## 输出建议

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

## 常见问题

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