TrendProof

Trend velocity intelligence for AI agents. Check whether a keyword is rising, stable, or falling before you create content, run ads, or build a product.

Live at trendproof.dev

Setup (API key)

Before doing anything else — check if the API key is already configured:

CODEBLOCK0

If no key is found, stop and tell the user exactly this (do not attempt any API calls):

"To use TrendProof, you need a free API key.

1. 1. Open https://trendproof.dev/dashboard#keys (sign up if needed — 5 free trial credits included)
2. Copy your key (starts with TRND_) and send it to me"

Once the user provides the key, save it:
CODEBLOCK1

Or set the environment variable:

export TRENDPROOF_API_KEY=TRND_xxxxx

Analyze a single keyword

CODEBLOCK3

Example output:
CODEBLOCK4

With location (UK example):

Raw JSON output:

python3 skills/trendproof/scripts/trendproof.py analyze "prompt engineering" --json

Batch analysis (ranked)

Compare multiple keywords and get them ranked by velocity:

CODEBLOCK7

Output (sorted by velocity score):
CODEBLOCK8

From a file:

File format (one keyword per line, # for comments):

# AI keywords
AI agents
LLM fine-tuning
RAG pipeline

Velocity score interpretation

Score formula: ((last 4 weeks avg − prior 4 weeks avg) / prior 4 weeks avg) × 100, capped at [-100, +200].

Related keywords

Discover similar keywords with volume and CPC:

CODEBLOCK11

Output:

  Similar to: AI agents

  Keyword                              Volume        CPC
  ─────────────────────────────────────────────────────────
  ai agent tools                        2,400      $3.10
  autonomous ai agents                  1,900      $4.20
  ...

API reference (direct HTTP)

For advanced use, call the API directly:

CODEBLOCK13

Response fields:

• - velocity_score — -100 to +200; positive = rising
• INLINECODE4 — rising | stable | INLINECODE7
• INLINECODE8 — monthly search volume
• INLINECODE9 — cost-per-click (USD)
• INLINECODE10 — estimated CPM (cpc × 2.5)
• INLINECODE11 — 0–1 (DataForSEO competition index)
• INLINECODE12 — date range of highest trend activity
• INLINECODE13 — last 12 months of volume data
• INLINECODE14 — 12-week Google Trends graph (0–100 values)
• INLINECODE15 — human-readable recommendation

Agent tool call pattern

When used as an AI agent tool, format results like:

"AI agents" — velocity +87 🚀 rising, 8,100/mo, CPC $2.45. Peak: Feb–Mar 2026. Act now before peak.

For batch comparisons, present as a ranked list with winner highlighted.

Troubleshooting

• - No key configured: Run configure --show. If empty → ask user to get key at https://trendproof.dev/dashboard#keys
• 401 / unauthorized: Key is set but invalid or revoked. Ask user to rotate at trendproof.dev/dashboard → API Keys → Rotate.
• 429 / credits exhausted: Upgrade at trendproof.dev/dashboard → Billing.
• Slow response (>5s): DataForSEO live API — expected for uncached keywords.
• score = 0 + stable: Likely very low-volume keyword; check trend_data array.