Description
Groundling Search adds DeepSeek as a connector of the AI Client built into WordPress 7.0. It appears in Settings > Connectors as “DeepSeek (Groundling Search)”.
Once it is connected, any plugin built on the AI Client can run on DeepSeek models. When that plugin asks for web search, the model searches the web through the DeepSeek Search API, reads the results, and answers with them instead of relying only on what it learned in training.
Why use it
- Fresh, grounded answers. Prices, versions, dates, news: the model looks them up before it writes.
- Your own DeepSeek account. You pay DeepSeek directly, at DeepSeek’s API rates. Nothing goes through a middleman.
- No new settings screen. You connect DeepSeek where WordPress expects it, in Settings > Connectors. WordPress stores the API key, not this plugin.
- Costs you can see. Each answer reports how many billable searches it used and how many tokens it read and wrote, so the plugin that called it can show the real cost.
Features
- DeepSeek text generation for the WordPress AI Client.
- Live web search as a tool the model calls on its own: up to 10 searches per request by default, 5 results each.
- Allowed and blocked domain lists set by the calling plugin are respected.
- Models are listed live from your DeepSeek account.
- DeepSeek Flash models also read images; other DeepSeek models are text only.
- Function calling and JSON output are passed through to DeepSeek.
- Search limits adjustable with two filters (see the FAQ).
- Clear errors: a rejected key points to Settings > Connectors, a failed search names its query.
Without a web search request, the plugin makes a plain DeepSeek chat call: no search runs and no search is billed.
Works with
Groundling Search works with any plugin that uses the WordPress AI Client. It is made by the team behind Unstale, the content refresh plugin, which uses it to update old posts with DeepSeek and live web search.
It also works alongside “AI Provider for DeepSeek”: the two register under different provider IDs and keep separate keys.
Requirements
- WordPress 7.0 or later (the AI Client is part of WordPress 7.0).
- PHP 8.1 or later.
- A DeepSeek API key from the DeepSeek Platform, on an account with credit.
This plugin is not affiliated with or endorsed by DeepSeek.
External services
This plugin connects to the DeepSeek API at https://api.deepseek.com, which it needs to generate text and to search the web.
- When a plugin on your site sends a request to the AI Client on a DeepSeek model, this plugin sends the prompt, the system instruction and the generation settings to https://api.deepseek.com/chat/completions.
- When that request needs web search, this plugin sends each search query written by the model to https://api.deepseek.com/v1/tools/search.
- WordPress lists the models of your account at https://api.deepseek.com/models when the connector is saved and whenever it checks which models are available (the list is cached, then refreshed).
Every request carries the API key you saved in Settings > Connectors. Nothing is sent before you save a key, and nothing is sent to any other host.
- DeepSeek terms of service: https://cdn.deepseek.com/policies/en-US/deepseek-open-platform-terms-of-service.html
- DeepSeek privacy policy: https://cdn.deepseek.com/policies/en-US/deepseek-privacy-policy.html
Installation
- Install and activate the plugin.
- Create an API key on the DeepSeek Platform: https://platform.deepseek.com
- Go to Settings > Connectors, find “DeepSeek (Groundling Search)”, paste the key and save.
- In the AI plugin you use, pick a DeepSeek model.
FAQ
How do I connect DeepSeek?
Go to Settings > Connectors, find the “DeepSeek (Groundling Search)” card, paste your DeepSeek API key and save. WordPress then lists the models of your account. Any plugin that uses the AI Client can now offer DeepSeek models.
Where do I get a DeepSeek API key?
Sign in to the DeepSeek Platform at https://platform.deepseek.com, add credit to the account, and create an API key. DeepSeek bills your account directly for tokens and searches.
Where is my API key stored?
WordPress stores it with its other connector keys. This plugin has no settings page and keeps no copy. Deleting the plugin deletes the key.
Does web search cost extra?
Yes. DeepSeek bills each successful search (one that returns results) separately from tokens, and the search results the model reads count as input tokens. A request runs at most 10 searches by default, and each answer reports how many billable searches it used. See the DeepSeek pricing page for current rates: https://api-docs.deepseek.com/quick_start/pricing/
When does the model search the web?
Only when the plugin that sends the request asks the AI Client for web search. The model then decides whether to search and what to search for. Without that request, no search runs.
Which DeepSeek models can I use?
The models your DeepSeek account offers, listed live from the DeepSeek API. Models with “flash” in their ID also accept images.
Can I change the search limits?
Yes, with the groundling_search_max_searches filter (1 to 50, default 10) and the groundling_search_max_rounds filter (1 to 20, default 8).
Can I use it with Unstale?
Yes. Unstale refreshes old posts with AI. Install both plugins, connect DeepSeek in Settings > Connectors, then pick DeepSeek Flash in the Unstale settings.
Can I keep “AI Provider for DeepSeek” active too?
Yes. The two plugins register under different provider IDs, each with its own key, and appear as two separate connectors.
Is this an official DeepSeek plugin?
No. It is an independent plugin that uses the public DeepSeek API. It is not affiliated with or endorsed by DeepSeek.
Changelog
1.0.0
- First release: DeepSeek text generation with live web search for the WordPress AI Client.
