feat(v1.5): contribution CTA + auto-gen tables + MCP server + agent docs + charts

[howardpen9]

Re-do of PR #12 — that one was auto-marked MERGED by GitHub when its parent PR #11 landed, but the actual v1.5 commits never made it to main. This branch is rebased onto current main and adds two new things on top of v1.5: auto-generated provider tables and bilingual notes schema.

Three feature groups + Notes-column squeeze fix

A) Lower contribution friction

• README "Want your relay listed?" section (en/zh-TW/zh-CN) above price snapshot — surfaces the issue template + PR path; sets expectation that status: unverified is normal until canary
• Enhanced .github/PULL_REQUEST_TEMPLATE.md with schema CI mention + operator-disclosure field
• New .github/workflows/pr-validate.yml runs scripts.validate on every PR touching data/, fetchers/, scripts/, pyproject.toml

B) Agent integration layer

• mcp/ — awesome-ai-api-proxy-mcp (separate PyPI package): 6 tools (list_providers, list_canonical_models, get_price, find_cheapest, compare, tier_overview) + data://prices/latest resource. FastMCP, stdio. Branch override via AWESOME_AI_API_PROXY_REF env var.
• docs/agent-integration.md — MCP / OpenAI function calling / LangChain / direct HTTP / pandas+DuckDB / n8n examples, same example question across all six paths
• CSV + Parquet exports in build_prices.py — gated on [charts] extra

C) Visualization

• scripts/build_charts.py — matplotlib SVG: tier-ladder bar chart (input + output) + cost-spread heatmap (rows × cols × log color)
• README embeds tier-ladder-input.svg inside prices markers
• docs/index.html — GitHub Pages dashboard (vanilla HTML + Plotly CDN, no build step). Reads raw prices.latest.json, renders interactive grouped bars + heatmap + filterable record table. docs/.nojekyll keeps it served raw.

D) Auto-generated provider tables (NEW vs PR #12)

Fixes the Notes-column squeeze (China relays table was 7 cols, now 5: Station / Type / Payment / Trust / Notes). Last-verified date and entity-registered info fold into the new Trust column as active · 2026-05-26 · registered.

Solves the contribution friction root cause: every prior provider PR (#1, #2, #5, #6, #8, #9) had to hand-edit three READMEs alongside providers.yaml. Now PRs only touch providers.yaml; tables auto-regenerate via the new scripts/build_provider_tables.py.

• providers.yaml notes can now be string OR bilingual dict {en, zh-TW, zh-CN}. All 19 existing entries migrated to bilingual; new entries can be English-only.
• schema.md and validate.py updated to enforce the new shape.

Pipeline

Weekly price-refresh.yml now installs [charts] extra and runs in order:
scrape → build_prices → build_charts → build_provider_tables → validate

Test plan

• Three fetchers pass (3/3, 1024 records, 47 canonical matches)
• CSV (185KB) + Parquet (24KB) generated alongside JSON
• 4 SVGs in assets/charts/, README embeds input ladder
• MCP server smoke-tested: find_cheapest("grok-4.3") → Relaydance $1.125
• build_provider_tables renders 12 section blocks (4 sections × 3 langs)
• scripts.validate exits 0
• Open a test PR mutating providers.yaml with a bad type → pr-validate.yml red-lights
• Enable GH Pages (Settings → Pages → main /docs already set) → dashboard at https://howardpen9.github.io/awesome-ai-api-proxy/
• Add MCP server to Claude Desktop → ask relay-pricing question → confirm tool call

Out of scope (v2)

• Historical trend charts (need ≥4 weeks of snapshots)
• Canary automation
• More fetchers (UiUiAPI / Yunwu / bltcy)
• Triaging the 5 remaining open backlog PRs (after this merges)

🤖 Generated with Claude Code