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:

python3 skills/trendproof/scripts/trendproof.py configure --show

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. 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:

python3 skills/trendproof/scripts/trendproof.py configure --api-key TRND_xxxxx

Or set the environment variable:

export TRENDPROOF_API_KEY=TRND_xxxxx

---

Analyze a single keyword

python3 skills/trendproof/scripts/trendproof.py analyze "AI agents"

Example output:

  Keyword      ai agents
  Velocity     [████████████░░░░░░░░] +87
  Direction    🚀  RISING
  Volume       8,100 / mo
  CPC          $2.45   CPM $6.13
  Competition  0.38
  Peak window  2026-02-10 — 2026-03-03
  Hint         🚀 Strong momentum — act now before peak. High CPC = strong intent.
  Took         1243ms

With location (UK example):

python3 skills/trendproof/scripts/trendproof.py analyze "rust programming" --location 2826

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:

python3 skills/trendproof/scripts/trendproof.py batch "AI agents" "LLM fine-tuning" "RAG pipeline" "vector search"

Output (sorted by velocity score):

Keyword                             Score  Direction    Volume     CPC
---------------------------------------------------------------------------
AI agents                           +87   🚀 rising    8,100    $2.45
RAG pipeline                        +34   🚀 rising    2,400    $1.80
LLM fine-tuning                      +8   📊 stable    5,500    $3.20
vector search                       -12   📉 falling   3,300    $1.10

  Total cost: $0.3360

From a file:

python3 skills/trendproof/scripts/trendproof.py batch-file keywords.txt

File format (one keyword per line,

#

for comments):

# AI keywords
AI agents
LLM fine-tuning
RAG pipeline

---

Velocity score interpretation

Score	Meaning
> 50	🚀 Strong uptrend — act now
10–50	🚀 Rising — good timing window
-10 to +10	📊 Stable — safe but no momentum
-10 to -50	📉 Declining — consider alternatives
< -50	📉 Sharp decline — avoid

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:

python3 skills/trendproof/scripts/trendproof.py related "AI agents"

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:

# Analyze
curl -s https://trendproof.dev/api/analyze \
  -H "Authorization: Bearer TRND_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "AI agents"}'

# Related keywords
curl -s https://trendproof.dev/api/related \
  -H "Authorization: Bearer TRND_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "AI agents"}'

# Public leaderboard (no auth)
curl -s "https://trendproof.dev/api/leaderboard?limit=10&sort=velocity"

Response fields:

• velocity_score

  — -100 to +200; positive = rising

• trend_direction

  —

  rising

  |

  stable

  |

  falling

• volume

  — monthly search volume

• cpc

  — cost-per-click (USD)

• cpm

  — estimated CPM (cpc × 2.5)

• competition

  — 0–1 (DataForSEO competition index)

• peak_window

  — date range of highest trend activity

• monthly_searches

  — last 12 months of volume data

• trend_data

  — 12-week Google Trends graph (0–100 values)

• action_hint

  — 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.