A Dify tool plugin that brings Diffbot web search, page extraction, and Knowledge Graph lookups into Dify agents and workflows.
The installable plugin is in diffbot/. Its README covers setup, credentials, and each tool, and PRIVACY.md is the plugin privacy policy. Marketplace publishing steps are in SUBMISSION.md.
- Source: https://github.com/diffbot/dify-diffbot
- Support: support@diffbot.com
- License: MIT
| Tool | Diffbot API |
|---|---|
| Web search | GET https://llm.diffbot.com/api/v1/web_search (bearer token) |
| Extract page | GET https://api.diffbot.com/v3/{analyze|article|product|discussion|image|video|list|event} (token query parameter) |
| Search organizations | POST https://kg.diffbot.com/kg/v3/dql |
| Search people | same DQL endpoint, public professional profiles only |
| Search news | same DQL endpoint, newest publication date first via sortBy:date |
| Start crawl | GET https://api.diffbot.com/v3/crawl (create only; returns a job name) |
| Crawl jobs | list / status / results / delete (destructive) on /v3/crawl and /v3/crawl/data |
| Resolve entities | POST https://nl.diffbot.com/v1/ |
Saving the credential checks GET https://api.diffbot.com/v4/account?days=1. Get a free token at app.diffbot.com/get-started.
Raw DQL, ontology lookup, Ask, places, and deals are not in this version. See SUBMISSION.md for why.
All HTTP goes through the Diffbot Python SDK (diffbot.Diffbot), behind a transport that refuses private, loopback, and cloud-metadata hosts.
Python 3.12+:
python -m venv .venv && . .venv/bin/activate
pip install -r requirements-dev.txt # dify_plugin, pytest, and diffbot==3.4.0
pytest -qdiffbot/requirements.txt pins diffbot==3.4.0, which is on PyPI. requirements-dev.txt does not contain a machine-local path.
The tests serve every request from httpx.MockTransport and make no Diffbot calls. The wiring tests run against the pinned SDK (diffbot==3.4.0) and its native verify_token, crawl_download, and extract options.
GitHub CI (.github/workflows/test.yml) installs diffbot/requirements.txt, including diffbot==3.4.0, and runs the full suite.
Install the Dify plugin CLI from langgenius/dify-plugin-daemon and run from the repository root:
dify plugin package ./diffbot -o dist/diffbot-0.1.0.difypkg
dify plugin checksum dist/diffbot-0.1.0.difypkgdist/ is ignored by git. The package is unsigned; Dify signs marketplace builds after review. Self-hosted Dify rejects unsigned local installs unless an administrator trusts a signature or turns off verification. Signing commands are in diffbot/README.md. Never commit a private key.
Marketplace validation is validator/validate-difypkg.py from langgenius/dify-marketplace-toolkit. The last result is recorded in SUBMISSION.md.