dfseo-cli — SEO Data from Your Terminal
Description: Open source CLI for DataForSEO APIs. 43+ commands for SERP analysis, keyword research, site audits, and backlink analysis. Built for AI agents.
Keywords: seo cli, dataforseo, serp api, keyword research tool, site audit cli, backlink analysis, ai agent tools

pip install dfseo

# SEO data from
your terminal.

43+ commands to search, analyze, and audit — built for AI agents and humans who prefer the command line. JSON-first, agent-native, pay-per-use.

Star on GitHub
bash

SEO tools charge $100+/month for data you can get with a single API call.

dfseo-cli cuts the middleman.

Ahrefs

$99/mo

SEMrush

$129/mo

dfseo-cli

$0.002/query

## Four APIs. One CLI.

Everything you need for SEO research, in your shell.

SERP Analysis

    $ dfseo serp google "your keyword" \
      --location "Italy" --depth 100

Google, Bing, YouTube. Any keyword, any location, real-time results. Includes featured snippets and People Also Ask.

Keyword Research

    $ dfseo keywords volume \
      "email hosting" "smtp provider" \
      --include-serp-info

Volume, CPC, difficulty, search intent. Up to 700 keywords per request. Bulk difficulty up to 1000.

Site Audit

    $ dfseo site audit "domain.com" \
      --max-pages 500

60+ on-page checks. Broken links. Duplicate content. Redirect chains. Lighthouse scores.

Backlink Analysis

    $ dfseo backlinks gap "you.com" \
      "competitor1.com" "competitor2.com"

Find who links to competitors but not to you. The ultimate link building weapon.

## Built for AI agents.
Usable by humans.

JSON on stdout. Errors on stderr. Semantic exit codes. Your agent parses the output. You read the table. Same data, different format.

Ships with `SKILL.md` for OpenClaw, Claude Code, and any skill-aware agent
Exit codes: 0 success · 2 auth error · 3 rate limit · 5 no balance
`--dry-run` shows cost estimates before any API call

# For agents

result=$(dfseo keywords difficulty "seo tool" -q)

echo $result | jq '.results[0].keyword_difficulty'

→ 72

# For humans

dfseo keywords difficulty "seo tool" --output table

Keyword │ KD │ Level

──────────┼────┼──────────

seo tool │ 72 │ ████████ Hard

## 43+ commands across 4 APIs

Everything covered, nothing duplicated.

SERP

8

serp google

serp bing

serp youtube

serp compare

serp locations

serp languages

auth setup

auth status

Keywords

8

keywords volume

keywords suggestions

keywords ideas

keywords difficulty

keywords search-intent

keywords for-site

keywords ads-volume

keywords ads-suggestions

Site Audit

12

site audit

site instant

site crawl

site summary

site pages

site links

site duplicates

site redirects

site non-indexable

site resources

site lighthouse

site tasks

Backlinks

13

backlinks summary

backlinks list

backlinks anchors

backlinks referring-domains

backlinks history

backlinks competitors

backlinks gap

backlinks pages

bulk ranks

bulk backlinks

bulk spam-score

bulk referring-domains

bulk new-lost

41 commands. 4 APIs. One CLI.

## Up in 60 seconds.

Three steps and you're searching.

1

Install

$ pip install dfseo
2

Authenticate

$ export DATAFORSEO_LOGIN="you@email.com"

$ export DATAFORSEO_PASSWORD="your_api_password"

3

Search

$ dfseo serp google "your first keyword"

Requires a DataForSEO API account. Free trial available.

## Drop it into any AI agent.

dfseo-cli ships with a `SKILL.md` file. Any agent that reads skill files can discover and use all commands automatically.

SKILL.md

---

name: dfseo

description: >

SEO data CLI powered by DataForSEO APIs.

Triggers on: SERP, keyword ranking,

backlink analysis, site audit

---

Works with: Claude Code · OpenClaw · Gemini CLI · Any shell-executing agent

## Ready to try it?

One command to install. Zero config to start.

Star on GitHub
GitHub PyPI DataForSEO Docs MIT License

Built with Python + Typer. Powered by DataForSEO APIs.