Skip to main content

Documentation Index

Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Three sub-commands for core SEO data:
CommandDescriptionMethod
naive seo keywords <engine> <endpoint>Keyword research via Google, Bing, or Google TrendsLive + Standard
naive seo backlinks <endpoint>Backlink profile analysisLive
naive seo labs <engine> <endpoint>Keyword + competitor research from LabsLive

Keywords Data

naive seo keywords google search-volume --keywords "ai tools,chatbot" --location 2840
naive seo keywords bing keywords-for-site --target "example.com" --location 2840
naive seo keywords google-trends explore --keywords "ai agents" --date-from 2025-01-01

Engines & Endpoints

EngineEndpoints
googlesearch-volume, keywords-for-keywords, keywords-for-site, keywords-for-category, ad-traffic-by-keywords, ad-traffic-by-platforms
bingsearch-volume, keywords-for-keywords, keywords-for-site, keywords-for-category, keyword-performance
google-trendsexplore

Options

FlagRequiredDescription
--keywords <list>VariesComma-separated keywords
--target <domain>VariesTarget domain or URL
--location <code>NoLocation code
--language <code>NoLanguage code
--date-from <date>NoStart date (YYYY-MM-DD)
--date-to <date>NoEnd date (YYYY-MM-DD)
--taskNoUse Standard (async) mode — submit as task instead of Live

naive seo backlinks summary --target example.com
naive seo backlinks referring-domains --target example.com --limit 50
naive seo backlinks competitors --target example.com
naive seo backlinks bulk-backlinks --targets "a.com,b.com,c.com"

Endpoints

EndpointDescription
summaryComplete backlink profile
historyHistorical backlink data
backlinksDetailed backlink list
anchorsAnchor texts and stats
referring-domainsReferring domain breakdown
competitorsSites sharing your backlink profile
domain-intersectionDomains linking to multiple targets
page-intersectionPages linking to multiple targets
bulk-backlinksBacklink counts for up to 1000 targets
bulk-spam-scoreSpam scores for multiple targets

Options

FlagRequiredDescription
--target <domain>YesDomain or URL to analyze
--targets <list>VariesComma-separated targets (for bulk endpoints)
--limit <n>NoMax results (default: 100)
--offset <n>NoPagination offset
--mode <mode>Noas_is, one_per_domain, one_per_anchor

Labs

naive seo labs google keyword-overview --keywords "project management" --location 2840
naive seo labs google ranked-keywords --target competitor.com
naive seo labs google serp-competitors --keywords "ai tools" --location 2840
naive seo labs bing related-keywords --keywords "software" --location 2840

Engines & Endpoints

EngineKeyword ResearchCompetitor ResearchCategories
googlekeyword-overview, keyword-suggestions, keyword-ideas, related-keywords, keywords-for-site, bulk-keyword-difficulty, search-intent, historical-keyword-dataranked-keywords, serp-competitors, competitors-domain, domain-intersection, domain-rank-overview, relevant-pages, subdomains, historical-serps, historical-rank-overview, page-intersection, bulk-traffic-estimationcategories-for-domain, keywords-for-categories, domain-metrics-by-categories, top-searches
bingrelated-keywords, bulk-keyword-difficultyranked-keywords, domain-rank-overview, serp-competitors, domain-intersection, page-intersection, relevant-pages, competitors-domain, subdomains, bulk-traffic-estimation
amazonbulk-search-volume, related-keywordsranked-keywords, product-rank-overview, product-competitors, product-keyword-intersections

Options

FlagRequiredDescription
--keywords <list>VariesComma-separated keywords
--keyword <word>VariesSingle keyword (for suggestion endpoints)
--target <domain>VariesTarget domain
--location <code>NoLocation code
--language <code>NoLanguage code
--limit <n>NoMax results
Use the naive_seo_discover MCP tool to find the right endpoint for your use case — it supports natural language filtering.