| name | news-report |
| description | Use for generating a professional news big-data report (舆情大数据报告) from the HandaaS news MCP — covering 舆情情感统计（4类情感+趋势）、舆情明细列表. Trigger when users ask for “舆情大数据报告”, “舆情分析报告”, “查一家公司的舆情”, “企业舆情监控”, “舆情统计”, “舆情明细”, “负面舆情”, “品牌声誉报告”, or “舆情趋势”. Infer the canonical enterprise name (auto-fuzzy-completing a keyword), pick the right MCP tools, and produce HTML + Markdown + JSON reports automatically. |
舆情大数据报告
用户契约
把“舆情大数据报告”作为面向用户的调用短语。news-report 仅为内部包名。
当本 skill 处于激活状态：
- 不要向用户索要 product_id、MCP 工具名、API 字段、内部参数或凭证信息；只接受企业名称、统一社会信用代码、注册号或企业 ID（以及可选的情感过滤）。
- 接受自然目标，例如“查一下某某公司的舆情”“监控这家企业的负面新闻”“给我一份舆情声誉报告”“看看这家公司舆情趋势”。
- 当用户只给关键词时，自动调用关键词模糊查询补全企业全称，再查舆情详情。
- 优先使用 MCP 连接（
NEWS_MCP_URL Remote MCP 或本地 handaas-mcp-server/news-mcp-server）；不要让用户处理签名或凭证。
- 同时产出 HTML（可分享交付）、Markdown（知识库 / wiki）、JSON（系统集成）三类产物。
- 报告正文必须是专业研究报告风格：只见舆情事实与结构化数据，绝不出现工具名、入参、product_id、内部字段或空表。
- 绝不打印
secret_id、secret_key、签名、token 或原始签名请求。
- 默认 dry-run；真实付费 / 凭证调用需用户明确要求且 MCP 连接配置完整。
- 数据为空时明确说明数据范围 / 口径，不渲染空表、不臆造事实。
- MCP 返回的嵌套 JSON 字符串（如金额
{"coinType":"人民币","value":430000000.0}、地址 {"city":"杭州市",...}）必须解析为可读文本（如"4.30 亿 人民币"、"浙江省杭州市"），绝不在报告正文、表格或指标中输出原始 JSON 字符串。
- 报告所有章节标题、指标卡标签必须用中文；
core_analysis.sections 的 title 字段必须中文，不可显示英文 key（如 holders、investments）。
- 指标值必须可读化：金额格式为"X 亿/万 + 币种"，地址拼接省市区，比率显示百分号。详见
references/report-output.md 的「数据格式约束」。
MCP 服务入口
- 上游 MCP 项目：
handaas-mcp-server/news-mcp-server（位于 HANDAAS_MCP_SERVER_ROOT 或本仓库同级目录）。
- Remote MCP：设置环境变量
NEWS_MCP_URL（streamable-http），可选 NEWS_MCP_TOKEN。
- 本地 MCP：设置
HANDAAS_MCP_SERVER_ROOT 指向 handaas-mcp-server 仓库根目录；该 server 自己的 .env 提供 INTEGRATOR_ID / SECRET_ID / SECRET_KEY。
- 首次真实查询前，运行
scripts/mcp_client.py ping 与 scripts/mcp_client.py list-tools 验证连通。
按需加载 references
- 不清楚该 MCP 有哪些工具、参数、返回字段、何时调用：
references/mcp-tools-reference.md。
- 报告结构、章节、质量底线、渲染工作流：
references/report-output.md。
意图路由
| 用户意图 | 内部工作流 |
|---|
| 查一家公司的全维度舆情报告 | 调舆情统计 + 舆情明细组装全量报告；compose_report.py --enterprise ... |
| 只要舆情统计 / 趋势 / 明细 | 仅调对应工具，按统一骨架组装 |
| 按情感过滤舆情明细（负面/正面/中性/未知） | compose_report.py --enterprise ... --sentiment 0|1|2|3 |
| 只给关键词（不是全称） | 先 news_bigdata_fuzzy_search 补全全称，再查详情 |
| 只要 JSON / 只要 HTML / 只要 Markdown | 用 --output（JSON）或 --report-output（HTML+MD），或 render_report.py 重渲染 |
| 连接 / 工具不存在 / 传参错误 | mcp_client.py ping / list-tools 排查；报脱敏后的缺失项 |
Golden path for 舆情大数据报告
- 解析企业全称：若输入含“公司/集团/有限/院/厂/中心/事务所/合作社/合伙”等后缀视为全称；否则调
news_bigdata_fuzzy_search 取首个命中。
- 调用舆情工具：
news_bigdata_news_stats（4类情感统计+趋势）、news_bigdata_news_list（舆情明细，可按 sentimentLabel 过滤）。入参为 matchKeyword（企业全称）+ keywordType。
- 组装统一报告：核心分析含舆情统计（KV：正/负/中/未知）、舆情情感趋势（表）、舆情列表（表）。
- 渲染三件套：
compose_report.py --enterprise ... --output ... --report-output ... 直接产出 JSON + HTML + Markdown；或 render_report.py --input ... --output ... 重渲染。
- 返回路径：返回 JSON、HTML、Markdown 文件路径，以及企业全称映射与数据口径（含情感过滤）。
脚本速查
python scripts/validate_config.py --allow-placeholders
python scripts/mcp_client.py ping
python scripts/mcp_client.py list-tools
python scripts/compose_report.py \
--enterprise "示例科技有限公司" \
--dry-run \
--output output/news.json \
--report-output output/news.html
python scripts/compose_report.py \
--enterprise "示例科技有限公司" \
--output output/news.json \
--report-output output/news.html
python scripts/compose_report.py --enterprise "示例科技有限公司" --sentiment 0 --report-output output/news_negative.html
python scripts/mcp_client.py call-tool \
--tool news_bigdata_news_stats \
--arguments-json '{"matchKeyword": "示例科技有限公司", "keywordType": "name"}'
python scripts/render_report.py --input output/news.json --output output/news.html
python scripts/render_report.py --input output/news.json --output output/news.md
输出字段
subject：企业全称、匹配关键词、主体类型、是否自动补全（含情感过滤）。abstract / summary：封面摘要与详细摘要。metrics：正面/负面/中性/未知舆情数、舆情明细数等指标卡。caliber：匹配对象、匹配方式（含情感过滤）、数据范围、产品、局限。core_analysis：舆情统计（KV）、舆情情感趋势（表）、舆情列表（表）。representative_records：代表性舆情记录（标题 / 来源 / 发布时间 / 情感）。insights：结构化解读（情感结构 / 舆情声量 / 中性占比）。data_source：MCP server、数据产品、生成时间、是否 dry-run。
若 API 调用失败，明确报出缺失的配置 / 缺失的工具 / MCP 错误 / 参数校验错误 / 上游网络错误，给出 dry-run 命令或配置步骤，绝不暴露密钥。
