An installable agent plugin that gives your coding agent access to Diffbot's web-scale knowledge graph and structured knowledge APIs. Query organizations, people, and articles with ontology-aware DQL — then enrich, extract, resolve entities, or crawl as needed.
Compatible with Claude Code, GitHub Copilot (CLI + VS Code), Snowflake Cortex Code, and Factory.ai (Droid).
Install directly from this public Git repository on every supported harness. Curated marketplace shortcuts are listed below where a catalog entry exists or is in progress.
Pinned release: v1.0.0 (44a20a931193596243d786ffb02959c8d75a5e8f)
Claude Code
git clone https://github.com/diffbot/diffbot-skills.git
cd diffbot-skills
claude --plugin-dir .Pass --plugin-dir with the repo path when you start Claude Code. Clone to a stable location if you use this regularly.
GitHub Copilot (CLI + VS Code)
copilot plugin install https://github.com/diffbot/diffbot-skills.gitSnowflake Cortex Code (CLI)
cortex plugin install diffbot/diffbot-skillsPin the release tag:
cortex plugin install github:diffbot/diffbot-skills@v1.0.0Cortex Code Desktop: Agent Settings → Plugins → Add from GitHub → diffbot/diffbot-skills (append #v1.0.0 to pin the tag).
Factory.ai (Droid)
droid plugin install https://github.com/diffbot/diffbot-skills.gitForgeCode: no installable manifest — copy or symlink the skills/ tree into .forge/skills/.
After install, invoke skills as /diffbot-dql, /diffbot-web-search, /diffbot-extract, /diffbot-entities, and /diffbot-crawl.
| Harness | Install | Catalog | Status |
|---|---|---|---|
| Claude Code | /plugin install diffbot@claude-plugins-official |
claude-plugins-official |
Submission in progress — see docs/listing/anthropic/ |
| GitHub Copilot | /plugin install diffbot@awesome-copilot |
awesome-copilot |
Submission in progress — see docs/listing/github/ |
| Factory (Droid) | droid plugin marketplace add https://github.com/Factory-AI/factory-plugins then droid plugin install diffbot@factory-plugins |
factory-plugins |
Not yet submitted — see docs/listing/factory/ |
| Cortex Code | cortex plugin install diffbot |
Official Cortex marketplace | No public form — partner channel; Git install works today — see docs/listing/cortex/ |
Listing playbooks and handoff bundles: docs/listing/.
- Get a Diffbot API token at app.diffbot.com/get-started.
- Save it to
~/.diffbot/credentials:
DIFFBOT_API_TOKEN=YOUR_TOKEN_HERE
Run this once on your machine (the skill will not write credentials for you):
echo "DIFFBOT_API_TOKEN=YOUR_TOKEN_HERE" > ~/.diffbot/credentials && chmod 600 ~/.diffbot/credentials- Invoke any skill — the first run bootstraps
~/.diffbot/venvand installsdiffbot-pythonfrom PyPI.
Five skills ship as one suite of structured-knowledge tools. DQL is the headline capability — ontology-aware entity querying that no other marketplace plugin offers.
Skill names are prefixed diffbot- to avoid collisions in the flat plugin namespace (e.g. /diffbot-dql, not /dql).
The agent translates your request into DQL, explores the ontology, probes query variants, and exports typed JSON or CSV.
/diffbot-dql find public semiconductor companies in the US
/diffbot-dql show me CTOs at public biotech companies
/diffbot-dql recent negative articles about OpenAI
/diffbot-dql top cities where data scientists work
/diffbot-dql software startups in Berlin under 100 employees with a female CEO
Ranked results with relevance scores, URLs, dates, and content snippets. Useful when you need current events beyond the KG crawl schedule.
/diffbot-web-search AI chip startups 2024
/diffbot-web-search recent earnings reports Tesla
Fetch and extract structured content from any URL — markdown by default, full JSON on request.
/diffbot-extract https://example.com/article
/diffbot-extract https://example.com/product-page
Identify and link entities in text to Diffbot KG records. Returns confidence, salience, sentiment, and Diffbot IDs usable in DQL.
/diffbot-entities Apple CEO Tim Cook announced record quarterly earnings.
/diffbot-entities Elon Musk founded Tesla and SpaceX.
Crawl a website for structured content and manage crawler jobs.
/diffbot-crawl https://docs.example.com
/diffbot-crawl https://example.com --url-process-pattern /blog/ --max-to-process 200
The Diffbot Knowledge Graph is a web-scale store of structured entities — organizations, people, articles, products, and more — each with a typed ontology of fields, composites, enums, and taxonomies. DQL lets the agent:
- Look up field names and types before constructing queries (
db dql ontology) - Probe query variants in parallel to validate selectivity
- Export results as JSON (for downstream analysis) or CSV (for display)
- Run facet aggregations for distribution questions
This is structured knowledge querying — not page fetching, not generic web search.
- Python 3.10+ (used to bootstrap
~/.diffbot/venv) - Diffbot API token (free tier available)
- A supported agent harness with plugin support (see Install)
Each skill pre-authorizes a minimal fixed-path Bash allowlist: db, venv creation, pip install, and jq (DQL only). No broad Bash(*) grants. Credentials are user-managed at ~/.diffbot/credentials and never stored in this repo.
MIT — see LICENSE.