Skip to content

Latest commit

 

History

History
57 lines (38 loc) · 3.12 KB

README.md

File metadata and controls

57 lines (38 loc) · 3.12 KB

Diffbot plugin for Dify

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.

Tools

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.

Run the tests

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 -q

diffbot/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.

Package

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.difypkg

dist/ 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.