Sofya

Web search, page fetch, AI extraction and deep research for Dify Agents and Workflows, through the Sofya API.

The plugin is a thin client. Every tool sends one HTTPS request to and returns the response as a JSON message plus a readable text message.

Setup

Create an API key in the Sofya dashboard at https://sofya.co/dashboard. Keys look like .
In Dify, install this plugin and open its settings.
Paste the key into the Sofya API key credential and save. Dify validates it with one snippets search, which costs 1 credit.

Required credential

Name	Type	Required
	secret	yes

The key is sent to Sofya as an header and nowhere else.

Connection requirements

Outbound HTTPS to only. The plugin never connects to any other host, and the API endpoint is a constant in the code rather than a tool parameter. Request timeouts are 65 seconds for search, fetch and extract, and 190 seconds for research.

Tools

Sofya Search

Searches the web and returns results that carry extracted page content, not only snippets.

Parameters: (required), ( default, or ), (1 to 20, default 10), (default false), , , ( default, or ), .

Example: , , . Returns 5 results with title, URL, published date and page content.

Sofya Fetch

Fetches up to 10 URLs and returns each page as clean markdown. Web pages, PDF, DOCX and other document formats are supported. URLs that fail cost no credits.

Parameters: (required, comma separated, up to 10), (default false).

Example: . Returns the page as markdown.

Sofya Extract

Reads one page and extracts the information you ask for. If the page has no usable text, the answer comes back empty with set instead of an invented answer.

Parameters: (required), (required).

Example: , .

Sofya Research

Splits a question into sub queries, reads many sources in parallel and returns a structured report with citations. A call can take a minute or two.

Parameters: (required), ( default, or ), , (5 to 30, default 20).

Example: , .

Credits

Action	Credits
Search, snippets depth	1
Search, basic depth	2
AI answer add on	10
Fetch	2 per URL
Extract	10
Research	50

Current plans and credit prices are at https://sofya.co/pricing.

Errors

API errors are returned as a text message, for example an invalid key, an empty credit balance or a rate limit. The API key is never included in an error message.

Source and contact

Source repository: https://github.com/yusufgurdogan/dify-plugin-sofya
Contact: [email protected]
Privacy policy: PRIVACY.md

MIT licensed.