ETF 推广覆盖 · 公众号推广图谱

把 ETF 的微信公众号推广数据聚合成一张覆盖图谱。这是给 B 端（基金公司市场部、自媒体运营）看的渠道情报，走的是专业圈层内传播，不是面向大众的荐基内容——所以角度是"谁在推、覆盖多广"，不是"该不该买"。

何时使用

用户想了解 ETF 的自媒体投放格局时使用。典型说法：这只 ETF 被谁在推、哪些公众号推广了 XX、某某号推了哪些基金、ETF 自媒体覆盖、找 ETF 相关博主。

三种模式

模式 A（按基金）：给一只 ETF 代码 → 看被哪些公众号推广。主力场景。
模式 B（按博主）：给一个公众号 → 看它推过哪些 ETF。
模式 C（找博主）：按名称/机构号属性/粉丝排序检索 ETF 博主。

用到的工具

quanshang_blogger_promotionByFund — 指定 ETF 被哪些博主推广（fundCode 必传）
quanshang_blogger_promotionByBlogger — 指定博主推广过哪些 ETF（biz 必传）
quanshang_blogger_bloggerList — 博主列表检索（pageNo/pageSize 必传）
quanshang_blogger_institutionStat — 机构号 vs 自媒体整体统计（无参数，用于给卡片补背景）

⚠️ 博主标识是 biz 不是名字：promotionByBlogger 要的是公众号唯一标识 biz，用户通常只给名字。所以模式 B 要先用 bloggerList(name=名字) 把名字解析成 biz，再查推广明细。 ⚠️ 多为快照表：bloggerList 的 date 是预留参数、不生效。别在卡片里承诺"某日"数据，用"截至最新"这类措辞。

MCP 接入

上面的工具由 leshu-v2 提供，配置如下（内置公开采样 key，开箱即用；该 key 已在服务端按采样工具集 + 配额封顶）：

{
  "mcpServers": {
    "leshu-v2": {
      "url": "https://asset.cdollar.cn/leshu-dashboard-new/mcp/common/v1",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJsZXNodS1tY3AtY2xpZW50Iiwic3ViIjoic2tpbGwiLCJpYXQiOjE3ODU3MjkyNjUsImNsaWVudE5hbWUiOiLpgZPkuZDnp5HmioAiLCJleHAiOjE5MTUzMjkyNjV9.6SZBqGxU_75MY5sMug-f61eTLkfjhyA6Xy62LnQCUIQ"
      }
    }
  }
}

工作流程

模式 A：这只 ETF 被谁在推

调 quanshang_blogger_promotionByFund，fundCode=用户给的代码。返回按粉丝降序的博主列表 + 文章链接。
（可选）调 quanshang_blogger_institutionStat 拿机构号/自媒体整体比例，给卡片补一句背景。
payload 里放 by_fund + inst_stat，交给脚本。

模式 B：某个号推了哪些 ETF

若用户只给名字：先 quanshang_blogger_bloggerList，name=名字、pageNo=1、pageSize=10，从返回里取 biz。命中多个同名，列出让用户确认。
调 quanshang_blogger_promotionByBlogger，biz=上一步的 biz。
payload 里放 by_blogger，交给脚本。

模式 C：找 ETF 博主

调 quanshang_blogger_bloggerList：name 模糊搜、institutionFilter（机构号/非机构号）、orderBy（fans 或 avgTopRead）。payload 里放 blogger_list，交给脚本。

组装

python3 scripts/build_card.py --input payload.json --mode fund   # 或 blogger / list

payload 结构（按模式传对应块即可）：

{
  "mode": "fund",
  "fund_name": "XX ETF", "fund_code": "512xxx",
  "by_fund":     <promotionByFund 原始返回>,
  "inst_stat":   <institutionStat 原始返回>,
  "blogger_name":"XX基金研究",
  "by_blogger":  <promotionByBlogger 原始返回>,
  "blogger_list":<bloggerList 原始返回>,
  "topn": 10
}

卡片模板

模式 A（按基金）：

📢 ETF 推广覆盖 · {fund_name}（{fund_code}）
被 {N} 个公众号推广（截至最新）

🏆 覆盖博主（按粉丝）
1. {bloggerName}｜{机构号/自媒体}｜粉丝 {fans}｜{postTime}
   {articleUrl}
2. …

——
数据来源：乐数
{免责声明}

模式 B / C 结构类似：B 列"该号推过的 ETF"，C 列"检索到的博主"。

合规与措辞

这一款是渠道情报、不涉荐基，合规压力比消费向的款轻，但仍守两条：

只做覆盖/事实呈现（谁推了、粉丝多少、文章在哪），不对 ETF 本身做涨跌判断或买入建议。
卡片带一句：

本卡片为公开推广数据聚合，仅供渠道分析参考，不构成投资建议。

输出示例

用户输入：512880 这只 ETF 都被哪些公众号在推？

处理：promotionByFund(fundCode=512880) → 可选 institutionStat 补背景 → --mode fund 套脚本 → 出覆盖图谱。