@diffbot/pi

Pi package that adds Diffbot tools to the coding agent — Knowledge Graph (DQL), Extract, Web Search, Entities, Crawl, Ask, and Ontology.

All runtime calls go through @diffbot/typescript. This package does not use the Python SDK or CLI.

Install

# from npm
pi install npm:@diffbot/pi

# from git
pi install git:github.com/diffbot/diffbot-pi

# from a local checkout
pi install .

Try without installing:

pi -e .

If you also have diffbot-skills discoverable in Pi, disable those skills (or remove them from settings). Skill names collide on purpose; package skills have lower precedence than user/auto skills, so the Python-oriented ones would win otherwise.

Auth

Token resolution (same as @diffbot/typescript):

1. DIFFBOT_API_TOKEN environment variable
2. DIFFBOT_API_TOKEN=... in ~/.diffbot/credentials

Check status in Pi with /diffbot.

Tools

Tool	Purpose
diffbot_dql	Query / export KG with DQL (filter, format, exportspec)
diffbot_dql_probe	Parallel hit counts for query variants
diffbot_ontology	Browse / refresh KG ontology
diffbot_extract	Extract structured content from a URL
diffbot_web_search	Search Diffbot's web index (maxTokens)
diffbot_entities	Named entities + sentiment (format: dql helper)
diffbot_ask	Diffbot LLM ask / short chat
diffbot_crawl	Start a Crawlbot job (optional watch)
diffbot_crawl_jobs	List or inspect crawler jobs
diffbot_crawl_delete	Delete a crawler job

Skills

Workflow guidance for those tools (parity with diffbot-skills, but invoking TS-backed Pi tools). Invoke with /skill:name:

Skill	Command
DQL / Knowledge Graph	/skill:diffbot-dql
Extract	/skill:diffbot-extract
Web Search	/skill:diffbot-web-search
Entities (NLP)	/skill:diffbot-entities
Crawl	/skill:diffbot-crawl
Ask	/skill:diffbot-ask

Develop

git clone https://github.com/diffbot/diffbot-pi.git
cd diffbot-pi
npm install
npm run typecheck

# load from this directory
pi -e .
# or install into user settings
pi install .

Depends on @diffbot/typescript from npm.

Package layout

Follows the Pi package conventions:

diffbot-pi/
├── extensions/     # TypeScript extensions (tools + /diffbot)
├── skills/         # Agent Skills (SKILL.md workflows)
├── package.json    # pi manifest + pi-package keyword
└── README.md

License

MIT