#!/usr/bin/env node const API_KEY = process.env.AHREFS_API_KEY const BASE_URL = 'https://api.ahrefs.com/v3' if (!API_KEY) { console.error(JSON.stringify({ error: 'AHREFS_API_KEY environment variable required' })) process.exit(1) } async function api(method, path) { if (args['dry-run']) { return { _dry_run: true, method, url: `${BASE_URL}${path}`, headers: { 'Authorization': '***', 'Content-Type': 'application/json' } } } const res = await fetch(`${BASE_URL}${path}`, { method, headers: { 'Authorization': `Bearer ${API_KEY}`, 'Content-Type': 'application/json', }, }) const text = await res.text() try { return JSON.parse(text) } catch { return { status: res.status, body: text } } } function parseArgs(args) { const result = { _: [] } for (let i = 0; i < args.length; i++) { const arg = args[i] if (arg.startsWith('--')) { const key = arg.slice(2) const next = args[i + 1] if (next && !next.startsWith('--')) { result[key] = next i++ } else { result[key] = true } } else { result._.push(arg) } } return result } const args = parseArgs(process.argv.slice(2)) const [cmd, sub, ...rest] = args._ async function main() { let result const mode = args.mode || 'domain' switch (cmd) { case 'domain-rating': switch (sub) { case 'get': { const params = new URLSearchParams({ target: args.target }) result = await api('GET', `/site-explorer/domain-rating?${params}`) break } default: result = { error: 'Unknown domain-rating subcommand. Use: get' } } break case 'backlinks': switch (sub) { case 'list': { const params = new URLSearchParams({ target: args.target, mode }) if (args.limit) params.set('limit', args.limit) result = await api('GET', `/site-explorer/backlinks?${params}`) break } default: result = { error: 'Unknown backlinks subcommand. Use: list' } } break case 'refdomains': switch (sub) { case 'list': { const params = new URLSearchParams({ target: args.target, mode }) if (args.limit) params.set('limit', args.limit) result = await api('GET', `/site-explorer/refdomains?${params}`) break } default: result = { error: 'Unknown refdomains subcommand. Use: list' } } break case 'keywords': switch (sub) { case 'organic': { const params = new URLSearchParams({ target: args.target, mode }) if (args.country) params.set('country', args.country) if (args.limit) params.set('limit', args.limit) result = await api('GET', `/site-explorer/organic-keywords?${params}`) break } default: result = { error: 'Unknown keywords subcommand. Use: organic' } } break case 'top-pages': switch (sub) { case 'list': { const params = new URLSearchParams({ target: args.target, mode }) if (args.country) params.set('country', args.country) if (args.limit) params.set('limit', args.limit) result = await api('GET', `/site-explorer/top-pages?${params}`) break } default: result = { error: 'Unknown top-pages subcommand. Use: list' } } break case 'keyword-overview': switch (sub) { case 'get': { const params = new URLSearchParams({ keywords: args.keywords }) if (args.country) params.set('country', args.country) result = await api('GET', `/keywords-explorer/overview?${params}`) break } default: result = { error: 'Unknown keyword-overview subcommand. Use: get' } } break case 'keyword-suggestions': switch (sub) { case 'get': { const params = new URLSearchParams({ keyword: args.keyword }) if (args.country) params.set('country', args.country) if (args.limit) params.set('limit', args.limit) result = await api('GET', `/keywords-explorer/matching-terms?${params}`) break } default: result = { error: 'Unknown keyword-suggestions subcommand. Use: get' } } break case 'serp': switch (sub) { case 'get': { const params = new URLSearchParams({ keyword: args.keyword }) if (args.country) params.set('country', args.country) result = await api('GET', `/keywords-explorer/serp-overview?${params}`) break } default: result = { error: 'Unknown serp subcommand. Use: get' } } break default: result = { error: 'Unknown command', usage: { 'domain-rating': 'domain-rating get --target ', 'backlinks': 'backlinks list --target [--mode ] [--limit ]', 'refdomains': 'refdomains list --target [--mode ] [--limit ]', 'keywords': 'keywords organic --target [--country ] [--limit ]', 'top-pages': 'top-pages list --target [--country ] [--limit ]', 'keyword-overview': 'keyword-overview get --keywords [--country ]', 'keyword-suggestions': 'keyword-suggestions get --keyword [--country ] [--limit ]', 'serp': 'serp get --keyword [--country ]', 'modes': 'domain (default), subdomains, prefix, exact', } } } console.log(JSON.stringify(result, null, 2)) } main().catch(err => { console.error(JSON.stringify({ error: err.message })) process.exit(1) })