swads-daily-report/SKILL.md

name, description

name	description
swads-daily-report	Generate a read-only SW Ads daily performance report for a named or current account, including normalized JSON, responsive HTML, and a shareable PNG. Use for 昨日日报、广告账户日报 or GMV Max daily performance reporting; not for changing delivery settings.

SW Ads Daily Report

Generate a decision-ready daily advertising report from the swads MCP. Query and render only; never change campaigns, budgets, ROI targets, creatives, product anchors, or delivery state.

Preconditions and scope

1. Call swads_whoami and verify the requested account is visible. Use its reporting timezone and currency.
2. Read metrics_catalog before querying. Use supported metric and dimension names.
3. Default to the most recent complete business day. Honor an explicit account or date exactly.
4. If authentication fails, tell the user to request a token from their administrator; never ask them to paste a token into chat.

Data and analysis

Collect account totals, campaign rows, delivered creative rows, data freshness, sync warnings, and supported runtime findings. For commerce accounts include spend, GMV, orders, product impressions/clicks, ROAS, and cost per order.

• Recompute ratios from aggregated numerators and denominators. Return N/A for missing or zero denominators.
• If account delivery fields conflict with commerce interaction fields, disclose the discrepancy and use the internally consistent commerce facts.
• Separate videos from product_card identities when comparing creative mix.
• Describe platform attribution as evidence, not causal incrementality.
• Distinguish low-volume uncertainty from confirmed underperformance.
• Output exactly three prioritized, data-backed recommendations.
• Put every proposed mutation under Requires human confirmation and do not execute it.

Artifacts

Write to ~/swads-reports/YYYY-MM-DD/ unless the user chooses another location:

• report-data.json: account, window, timezone/currency, freshness, totals, campaign/creative rows, findings, recommendations, and limitations.
• swads-daily-report.html: self-contained responsive Wise-style HTML with restrained green styling.
• swads-daily-report.png: full-page rendering when a browser renderer is available. Visually inspect it and rerender if text is clipped or unreadable.

Do not include credentials or unrelated account data. Lead the response with the business outcome and main risk, then link the artifacts and confirm the workflow was read-only.