qwwiwi/agentos-skills-public/datawrapper

Datawrapper Chart Skill

What it does

Creates charts and tables via Datawrapper API (datawrapper.de). Accepts CSV, JSON, or inline data. Publishes and optionally exports PNG.

When to use

• User asks for a chart, graph, or table from data
• Result should be embeddable or shareable via URL
• Need PNG to send in chat/Telegram
• Triggers: "chart", "graph", "dashboard", "visualization", "datawrapper", "embed"

Do NOT use when

• Only need a local matplotlib image (no hosting)
• Need PDF/SVG export (paid Datawrapper plan)
• Browser automation required

Requirements

Environment variable: DATAWRAPPER_API_KEY Token scopes: chart:write, chart:read, theme:read, visualization:read

Get your API key at: https://app.datawrapper.de/account/api-tokens

Chart types

See references/chart-types.md for the full list including maps.

Command

python3 {baseDir}/scripts/datawrapper_chart.py \
  --type d3-bars \
  --data-file /path/to/data.csv \
  --title "My Chart" \
  --publish --export-png

All arguments

*One of --data-file or --data-inline required.

Input formats

1. CSV file: --data-file prices.csv
2. JSON file: --data-file buys.json (array of objects or {columns, rows})
3. Inline CSV: --data-inline "date,price\n2026-03-01,82000"
4. Pipe table: auto-detected, split on |

Max file size: 10MB.

Output

Structured JSON to stdout:

{
  "ok": true,
  "chart_id": "Ab12C",
  "chart_type": "d3-lines",
  "edit_url": "https://app.datawrapper.de/chart/Ab12C/visualize",
  "public_url": "https://datawrapper.dwcdn.net/Ab12C/1/",
  "embed_url": "https://datawrapper.dwcdn.net/Ab12C/1/",
  "png_path": "/tmp/Ab12C.png"
}

Examples

Bar chart from CSV + PNG export:

python3 {baseDir}/scripts/datawrapper_chart.py \
  --type d3-bars \
  --data-file /tmp/data.csv \
  --title "My Chart" \
  --source-name "Data source" \
  --publish --export-png

Line chart inline:

python3 {baseDir}/scripts/datawrapper_chart.py \
  --type d3-lines \
  --data-inline "date,price
2026-03-01,70000
2026-03-15,74000" \
  --title "Price History" --publish

Notes

• Free plan: unlimited create + publish + PNG export
• Free plan shows "Created with Datawrapper" watermark
• PDF/SVG export requires paid plan
• --dark uses theme ID datawrapper-dark. If unavailable on your account, use --theme with your custom theme ID
• PNG export retries up to 3 times on transient errors