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>
This commit is contained in:
Corey Haines
@@ -40,10 +40,12 @@ Every CLI reads credentials from environment variables:
|
||||
| `adobe-analytics` | `ADOBE_CLIENT_ID`, `ADOBE_ACCESS_TOKEN` |
|
||||
| `amplitude` | `AMPLITUDE_API_KEY`, `AMPLITUDE_SECRET_KEY` |
|
||||
| `customer-io` | `CUSTOMERIO_APP_KEY` (App API), `CUSTOMERIO_SITE_ID` + `CUSTOMERIO_API_KEY` (Track API) |
|
||||
| `dataforseo` | `DATAFORSEO_LOGIN`, `DATAFORSEO_PASSWORD` |
|
||||
| `dub` | `DUB_API_KEY` |
|
||||
| `ga4` | `GA4_ACCESS_TOKEN` |
|
||||
| `google-ads` | `GOOGLE_ADS_TOKEN`, `GOOGLE_ADS_DEVELOPER_TOKEN` |
|
||||
| `google-search-console` | `GSC_ACCESS_TOKEN` |
|
||||
| `keywords-everywhere` | `KEYWORDS_EVERYWHERE_API_KEY` |
|
||||
| `kit` | `KIT_API_KEY`, `KIT_API_SECRET` |
|
||||
| `linkedin-ads` | `LINKEDIN_ACCESS_TOKEN` |
|
||||
| `mailchimp` | `MAILCHIMP_API_KEY` |
|
||||
@@ -104,6 +106,8 @@ DOMAINS=$(rewardful affiliates list | jq -r '.data[].email')
|
||||
| `ahrefs.js` | SEO | [Ahrefs](https://ahrefs.com) |
|
||||
| `semrush.js` | SEO | [SEMrush](https://semrush.com) |
|
||||
| `google-search-console.js` | SEO | [Google Search Console](https://search.google.com/search-console) |
|
||||
| `dataforseo.js` | SEO | [DataForSEO](https://dataforseo.com) |
|
||||
| `keywords-everywhere.js` | SEO | [Keywords Everywhere](https://keywordseverywhere.com) |
|
||||
| `ga4.js` | Analytics | [Google Analytics 4](https://analytics.google.com) |
|
||||
| `mixpanel.js` | Analytics | [Mixpanel](https://mixpanel.com) |
|
||||
| `amplitude.js` | Analytics | [Amplitude](https://amplitude.com) |
|
||||
|
||||
Executable
+254
@@ -0,0 +1,254 @@
|
||||
#!/usr/bin/env node
|
||||
|
||||
const LOGIN = process.env.DATAFORSEO_LOGIN
|
||||
const PASSWORD = process.env.DATAFORSEO_PASSWORD
|
||||
const BASE_URL = 'https://api.dataforseo.com/v3'
|
||||
|
||||
if (!LOGIN || !PASSWORD) {
|
||||
console.error(JSON.stringify({ error: 'DATAFORSEO_LOGIN and DATAFORSEO_PASSWORD environment variables required' }))
|
||||
process.exit(1)
|
||||
}
|
||||
|
||||
const AUTH = 'Basic ' + Buffer.from(`${LOGIN}:${PASSWORD}`).toString('base64')
|
||||
|
||||
async function api(method, path, body) {
|
||||
const res = await fetch(`${BASE_URL}${path}`, {
|
||||
method,
|
||||
headers: {
|
||||
'Authorization': AUTH,
|
||||
'Content-Type': '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 location = args.location || 'United States'
|
||||
const locationCode = args['location-code'] ? Number(args['location-code']) : 2840
|
||||
const language = args.language || 'English'
|
||||
const languageCode = args['language-code'] || 'en'
|
||||
const limit = args.limit ? Number(args.limit) : 100
|
||||
|
||||
switch (cmd) {
|
||||
case 'serp':
|
||||
switch (sub) {
|
||||
case 'google': {
|
||||
const keyword = args.keyword
|
||||
if (!keyword) { result = { error: '--keyword required' }; break }
|
||||
result = await api('POST', '/serp/google/organic/live/regular', [{
|
||||
keyword,
|
||||
location_name: location,
|
||||
language_name: language,
|
||||
}])
|
||||
break
|
||||
}
|
||||
case 'locations':
|
||||
result = await api('GET', '/serp/google/locations')
|
||||
break
|
||||
case 'languages':
|
||||
result = await api('GET', '/serp/google/languages')
|
||||
break
|
||||
default:
|
||||
result = { error: 'Unknown serp subcommand. Use: google, locations, languages' }
|
||||
}
|
||||
break
|
||||
|
||||
case 'keywords':
|
||||
switch (sub) {
|
||||
case 'volume': {
|
||||
const keywords = args.keywords?.split(',')
|
||||
if (!keywords) { result = { error: '--keywords required (comma-separated)' }; break }
|
||||
result = await api('POST', '/keywords_data/google_ads/search_volume/live', [{
|
||||
keywords,
|
||||
location_code: locationCode,
|
||||
language_code: languageCode,
|
||||
}])
|
||||
break
|
||||
}
|
||||
case 'for-site': {
|
||||
const target = args.target
|
||||
if (!target) { result = { error: '--target required (domain)' }; break }
|
||||
result = await api('POST', '/keywords_data/google_ads/keywords_for_site/live', [{
|
||||
target,
|
||||
location_code: locationCode,
|
||||
language_code: languageCode,
|
||||
}])
|
||||
break
|
||||
}
|
||||
case 'for-keywords': {
|
||||
const keywords = args.keywords?.split(',')
|
||||
if (!keywords) { result = { error: '--keywords required (comma-separated)' }; break }
|
||||
result = await api('POST', '/keywords_data/google_ads/keywords_for_keywords/live', [{
|
||||
keywords,
|
||||
location_code: locationCode,
|
||||
language_code: languageCode,
|
||||
}])
|
||||
break
|
||||
}
|
||||
case 'trends': {
|
||||
const keywords = args.keywords?.split(',')
|
||||
if (!keywords) { result = { error: '--keywords required (comma-separated)' }; break }
|
||||
result = await api('POST', '/keywords_data/google_trends/explore/live', [{
|
||||
keywords,
|
||||
location_code: locationCode,
|
||||
language_code: languageCode,
|
||||
}])
|
||||
break
|
||||
}
|
||||
default:
|
||||
result = { error: 'Unknown keywords subcommand. Use: volume, for-site, for-keywords, trends' }
|
||||
}
|
||||
break
|
||||
|
||||
case 'backlinks':
|
||||
switch (sub) {
|
||||
case 'summary': {
|
||||
const target = args.target
|
||||
if (!target) { result = { error: '--target required' }; break }
|
||||
result = await api('POST', '/backlinks/summary/live', [{
|
||||
target,
|
||||
backlinks_status_type: 'live',
|
||||
}])
|
||||
break
|
||||
}
|
||||
case 'list': {
|
||||
const target = args.target
|
||||
if (!target) { result = { error: '--target required' }; break }
|
||||
result = await api('POST', '/backlinks/backlinks/live', [{
|
||||
target,
|
||||
mode: args.mode || 'as_is',
|
||||
limit,
|
||||
backlinks_status_type: 'live',
|
||||
}])
|
||||
break
|
||||
}
|
||||
case 'refdomains': {
|
||||
const target = args.target
|
||||
if (!target) { result = { error: '--target required' }; break }
|
||||
result = await api('POST', '/backlinks/referring_domains/live', [{
|
||||
target,
|
||||
limit,
|
||||
}])
|
||||
break
|
||||
}
|
||||
case 'anchors': {
|
||||
const target = args.target
|
||||
if (!target) { result = { error: '--target required' }; break }
|
||||
result = await api('POST', '/backlinks/anchors/live', [{
|
||||
target,
|
||||
limit,
|
||||
}])
|
||||
break
|
||||
}
|
||||
case 'index':
|
||||
result = await api('GET', '/backlinks/index')
|
||||
break
|
||||
default:
|
||||
result = { error: 'Unknown backlinks subcommand. Use: summary, list, refdomains, anchors, index' }
|
||||
}
|
||||
break
|
||||
|
||||
case 'onpage':
|
||||
switch (sub) {
|
||||
case 'audit': {
|
||||
const url = args.url
|
||||
if (!url) { result = { error: '--url required' }; break }
|
||||
result = await api('POST', '/on_page/instant_pages', [{
|
||||
url,
|
||||
enable_javascript: args['no-js'] ? false : true,
|
||||
}])
|
||||
break
|
||||
}
|
||||
default:
|
||||
result = { error: 'Unknown onpage subcommand. Use: audit' }
|
||||
}
|
||||
break
|
||||
|
||||
case 'labs':
|
||||
switch (sub) {
|
||||
case 'competitors': {
|
||||
const target = args.target
|
||||
if (!target) { result = { error: '--target required' }; break }
|
||||
result = await api('POST', '/dataforseo_labs/google/competitors_domain/live', [{
|
||||
target,
|
||||
location_code: locationCode,
|
||||
language_code: languageCode,
|
||||
limit,
|
||||
}])
|
||||
break
|
||||
}
|
||||
case 'ranked-keywords': {
|
||||
const target = args.target
|
||||
if (!target) { result = { error: '--target required' }; break }
|
||||
result = await api('POST', '/dataforseo_labs/google/ranked_keywords/live', [{
|
||||
target,
|
||||
location_code: locationCode,
|
||||
language_code: languageCode,
|
||||
limit,
|
||||
}])
|
||||
break
|
||||
}
|
||||
case 'domain-intersection': {
|
||||
const targets = args.targets?.split(',')
|
||||
if (!targets || targets.length < 2) { result = { error: '--targets required (comma-separated, at least 2 domains)' }; break }
|
||||
const payload = { location_code: locationCode, language_code: languageCode, limit }
|
||||
targets.forEach((t, i) => { payload[`target${i + 1}`] = t })
|
||||
result = await api('POST', '/dataforseo_labs/google/domain_intersection/live', [payload])
|
||||
break
|
||||
}
|
||||
default:
|
||||
result = { error: 'Unknown labs subcommand. Use: competitors, ranked-keywords, domain-intersection' }
|
||||
}
|
||||
break
|
||||
|
||||
default:
|
||||
result = {
|
||||
error: 'Unknown command',
|
||||
usage: {
|
||||
serp: 'serp [google --keyword <kw> | locations | languages]',
|
||||
keywords: 'keywords [volume --keywords <kw1,kw2> | for-site --target <domain> | for-keywords --keywords <kw1,kw2> | trends --keywords <kw1,kw2>]',
|
||||
backlinks: 'backlinks [summary --target <domain> | list --target <domain> | refdomains --target <domain> | anchors --target <domain> | index]',
|
||||
onpage: 'onpage [audit --url <url>]',
|
||||
labs: 'labs [competitors --target <domain> | ranked-keywords --target <domain> | domain-intersection --targets <d1,d2>]',
|
||||
options: '--location-code <code> --language-code <code> --limit <n>',
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
console.log(JSON.stringify(result, null, 2))
|
||||
}
|
||||
|
||||
main().catch(err => {
|
||||
console.error(JSON.stringify({ error: err.message }))
|
||||
process.exit(1)
|
||||
})
|
||||
Executable
+181
@@ -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)
|
||||
})
|
||||
Reference in New Issue
Block a user