How to Build a Rank Tracker on Cloudflare Workers

// wrangler.toml config:
// name = "rank-tracker"
// [triggers]
// crons = ["0 6 * * *"]  # Daily at 6 AM UTC
// [[kv_namespaces]]
// binding = "RANKINGS"
// id = "your-kv-namespace-id"

export default {
  async scheduled(event, env, ctx) {
    const keywords = ['search api python', 'mcp search tool', 'serp api alternative', 'web search api pricing'];
    const domain = 'scavio.dev';
    const results = [];
    for (const kw of keywords) {
      const resp = await fetch('https://api.scavio.dev/api/v1/search', {
        method: 'POST',
        headers: { 'x-api-key': env.SCAVIO_API_KEY, 'Content-Type': 'application/json' },
        body: JSON.stringify({ query: kw, country_code: 'us' }),
      });
      const data = await resp.json();
      const organic = data.organic_results || [];
      const pos = organic.findIndex(r => r.link?.includes(domain));
      results.push({ keyword: kw, position: pos >= 0 ? pos + 1 : null, date: new Date().toISOString().split('T')[0] });
    }
    // Store in KV
    const today = new Date().toISOString().split('T')[0];
    await env.RANKINGS.put(`rankings:${today}`, JSON.stringify(results));
    console.log(`Tracked ${results.length} keywords. Cost: $${(keywords.length * 0.005).toFixed(3)}`);
  },

  async fetch(request, env) {
    // Dashboard endpoint
    const url = new URL(request.url);
    if (url.pathname === '/api/rankings') {
      const today = new Date().toISOString().split('T')[0];
      const data = await env.RANKINGS.get(`rankings:${today}`);
      return new Response(data || '[]', { headers: { 'Content-Type': 'application/json' } });
    }
    return new Response('Rank Tracker. GET /api/rankings for today.');
  }
};

async function getHistory(env, days = 30) {
  const history = [];
  for (let i = 0; i < days; i++) {
    const date = new Date(Date.now() - i * 86400000).toISOString().split('T')[0];
    const data = await env.RANKINGS.get(`rankings:${date}`);
    if (data) {
      history.push({ date, rankings: JSON.parse(data) });
    }
  }
  return history.reverse();
}

async function getTrends(env, keyword) {
  const history = await getHistory(env);
  const positions = [];
  for (const day of history) {
    const entry = day.rankings.find(r => r.keyword === keyword);
    if (entry) {
      positions.push({ date: day.date, position: entry.position });
    }
  }
  if (positions.length < 2) return { trend: 'insufficient_data', positions };
  const latest = positions[positions.length - 1].position;
  const previous = positions[positions.length - 2].position;
  let trend = 'stable';
  if (latest && previous) {
    if (latest < previous) trend = 'improving';
    else if (latest > previous) trend = 'declining';
  } else if (latest && !previous) {
    trend = 'new_ranking';
  } else if (!latest && previous) {
    trend = 'lost_ranking';
  }
  return { trend, positions, latest, previous };
}

// Usage in fetch handler:
// const trends = await getTrends(env, 'search api python');
// return new Response(JSON.stringify(trends));
console.log('Trend tracking configured with 30-day KV history');

// Deploy steps:
// 1. wrangler secret put SCAVIO_API_KEY
// 2. wrangler deploy
// 3. wrangler kv:namespace create RANKINGS

// Test locally:
// wrangler dev
// curl http://localhost:8787/api/rankings

// Test the scheduled trigger:
// wrangler dev --test-scheduled

// Verify in production:
async function verifyDeployment() {
  const resp = await fetch('https://rank-tracker.your-subdomain.workers.dev/api/rankings');
  const data = await resp.json();
  console.log(`Rankings for today: ${data.length} keywords`);
  for (const r of data) {
    const pos = r.position ? `#${r.position}` : 'not found';
    console.log(`  ${r.keyword.padEnd(30)} | ${pos}`);
  }
}

// Cost breakdown:
// Cloudflare Workers: Free tier (100K req/day)
// Scavio API: 4 keywords x $0.005 = $0.020/day
// Monthly: $0.60/month for daily tracking
// vs. Ahrefs: $99/mo, SEMrush: $129/mo
console.log('Deployed. $0.020/day for 4 keywords.');
console.log('Monthly: $0.60 vs Ahrefs $99/mo');