feat: add DataForSEO and Keywords Everywhere CLIs and integration guides

Add two new SEO tool integrations with zero-dependency CLI tools and detailed API documentation for agent use. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 11:10:47 -08:00
parent 98bd9ede62
commit 8dba2d53de
6 changed files with 816 additions and 1 deletions
@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+
+const API_KEY = process.env.KEYWORDS_EVERYWHERE_API_KEY
+const BASE_URL = 'https://api.keywordseverywhere.com/v1'
+
+if (!API_KEY) {
+  console.error(JSON.stringify({ error: 'KEYWORDS_EVERYWHERE_API_KEY environment variable required' }))
+  process.exit(1)
+}
+
+async function api(method, path, body) {
+  const res = await fetch(`${BASE_URL}${path}`, {
+    method,
+    headers: {
+      'Authorization': `Bearer ${API_KEY}`,
+      'Content-Type': 'application/json',
+      'Accept': 'application/json',
+    },
+    body: body ? JSON.stringify(body) : undefined,
+  })
+  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 country = args.country || 'us'
+  const currency = args.currency || 'USD'
+  const dataSource = args['data-source'] || 'gkp'
+
+  switch (cmd) {
+    case 'keywords':
+      switch (sub) {
+        case 'data': {
+          const kw = args.kw?.split(',')
+          if (!kw) { result = { error: '--kw required (comma-separated keywords, max 100)' }; break }
+          result = await api('POST', '/get_keyword_data', { country, currency, dataSource, kw })
+          break
+        }
+        case 'related': {
+          const kw = args.kw?.split(',')
+          if (!kw) { result = { error: '--kw required (comma-separated keywords)' }; break }
+          result = await api('POST', '/get_related_keywords', { country, currency, dataSource, kw })
+          break
+        }
+        case 'pasf': {
+          const kw = args.kw?.split(',')
+          if (!kw) { result = { error: '--kw required (comma-separated keywords)' }; break }
+          result = await api('POST', '/get_pasf_keywords', { country, currency, dataSource, kw })
+          break
+        }
+        default:
+          result = { error: 'Unknown keywords subcommand. Use: data, related, pasf' }
+      }
+      break
+
+    case 'domain':
+      switch (sub) {
+        case 'keywords': {
+          const domain = args.domain
+          if (!domain) { result = { error: '--domain required' }; break }
+          result = await api('POST', '/get_domain_keywords', { country, currency, domain })
+          break
+        }
+        case 'traffic': {
+          const domain = args.domain
+          if (!domain) { result = { error: '--domain required' }; break }
+          result = await api('POST', '/get_domain_traffic', { country, domain })
+          break
+        }
+        case 'backlinks': {
+          const domain = args.domain
+          if (!domain) { result = { error: '--domain required' }; break }
+          result = await api('POST', '/get_domain_backlinks', { domain })
+          break
+        }
+        case 'unique-backlinks': {
+          const domain = args.domain
+          if (!domain) { result = { error: '--domain required' }; break }
+          result = await api('POST', '/get_unique_domain_backlinks', { domain })
+          break
+        }
+        default:
+          result = { error: 'Unknown domain subcommand. Use: keywords, traffic, backlinks, unique-backlinks' }
+      }
+      break
+
+    case 'url':
+      switch (sub) {
+        case 'keywords': {
+          const url = args.url
+          if (!url) { result = { error: '--url required' }; break }
+          result = await api('POST', '/get_url_keywords', { country, currency, url })
+          break
+        }
+        case 'traffic': {
+          const url = args.url
+          if (!url) { result = { error: '--url required' }; break }
+          result = await api('POST', '/get_url_traffic', { country, url })
+          break
+        }
+        case 'backlinks': {
+          const url = args.url
+          if (!url) { result = { error: '--url required' }; break }
+          result = await api('POST', '/get_page_backlinks', { url })
+          break
+        }
+        case 'unique-backlinks': {
+          const url = args.url
+          if (!url) { result = { error: '--url required' }; break }
+          result = await api('POST', '/get_unique_page_backlinks', { url })
+          break
+        }
+        default:
+          result = { error: 'Unknown url subcommand. Use: keywords, traffic, backlinks, unique-backlinks' }
+      }
+      break
+
+    case 'account':
+      switch (sub) {
+        case 'credits':
+          result = await api('GET', '/get_credits')
+          break
+        case 'countries':
+          result = await api('GET', '/get_countries')
+          break
+        case 'currencies':
+          result = await api('GET', '/get_currencies')
+          break
+        default:
+          result = { error: 'Unknown account subcommand. Use: credits, countries, currencies' }
+      }
+      break
+
+    default:
+      result = {
+        error: 'Unknown command',
+        usage: {
+          keywords: 'keywords [data|related|pasf] --kw <kw1,kw2,...>',
+          domain: 'domain [keywords|traffic|backlinks|unique-backlinks] --domain <domain>',
+          url: 'url [keywords|traffic|backlinks|unique-backlinks] --url <url>',
+          account: 'account [credits|countries|currencies]',
+          options: '--country <us> --currency <USD> --data-source <gkp>',
+        }
+      }
+  }
+
+  console.log(JSON.stringify(result, null, 2))
+}
+
+main().catch(err => {
+  console.error(JSON.stringify({ error: err.message }))
+  process.exit(1)
+})