Market Insight Agent — 火山引擎市场洞察助手

用途与设计目标

本 Skill 旨在为 Agent 提供一个统一、稳定且无感的市场洞察服务调用入口。它整合了 market-insight-agent-v2-optimized（零依赖 Gateway 版本）和 market-insight-agent-portable-sdk（官方 SDK 版本）的优点，实现了以下目标：

统一调用路径：无论底层采用 API Gateway 还是官方 SDK，对 Agent 而言，始终通过 scripts/client.py 中 list_custom_subs_task、pull_post、query_clue_info 三个函数以相同的方式调用。
动态 Provider 选择：默认优先使用 API Gateway 方式。同时，Skill 能够根据当前环境（如环境变量配置）和运行时状态（如某条链路连续失败）动态地、智能地选择最佳调用路径。
SDK 自动安装：当需要使用 SDK 路径但环境中未安装 volcengine-python-sdk 时，Skill 会自动尝试安装，实现真正的“开箱即用”。
状态与凭证持久化：Skill 会将其运行状态（如上次成功的 Provider）和用户提供的凭证（若通过“最小化询问”获得）持久化到 Skill 私有的 persist/ 目录中，实现会话间的状态保持和凭证复用。
最小化询问：仅在完全没有可用凭证或所有链路均认证失败时，才向 Agent 层发出明确的“最小化询问”请求，由 Agent 决定何时以及如何向用户获取凭证，避免了不必要的打扰。

触发场景

当需要与火山引擎市场洞察服务交互时，应使用本 Skill。具体场景包括但不限于：

品牌声量监测：获取关于特定品牌或产品的社交媒体讨论。
竞品动态追踪：监控竞争对手的市场活动、用户反馈。