Introduction

When using an external agent skill in DSH, you typically need to confirm three things first: where the skill package comes from, how it is discovered by DSH, and the environments required by the running scripts. xuboboo/dsh-grok-geo provides a DSH bundle plugin: once installed, DSH’s skill tool can discover and load grok-geo to perform AI search / GEO audits for a single brand.

The DSH ecosystem emphasizes “everything is a plugin”; the community directory is an independent site with no official affiliation with DeepSeek or Huanqiu. Below, we introduce this plugin in terms of installation, usage, and capability boundaries.

What is this

xuboboo/dsh-grok-geo is a DSH bundle maintained by xuboboo under the MIT license.

It registers grok-geo as a bundled skill provider within DSH and distributes the complete skill package with the plugin. It is primarily aimed at AI search / GEO audits for single brands, covering:

  • Visibility
  • Recommendations and citations
  • Competitor comparison
  • Factual accuracy
  • Content gaps

The verified engine scope includes 17+ mainstream AI search engines, comprising 8 international and 9 Chinese engines, such as ChatGPT, Perplexity, Claude, Gemini, Doubao, DeepSeek, Kimi, and Wenxin Yiyan…

Core Capabilities

The verified capabilities of dsh-grok-geo are as follows:

  • Perform AI search / GEO audits for a single brand: visibility, recommendations and citations, competitor comparison, factual accuracy, content gaps.
  • Support for 17+ mainstream AI search engines, including 8 international and 9 Chinese engines.
  • Registers as a bundled skill provider in the form of a DSH bundle plugin and distributes the complete skill package with the plugin.
  • Pipeline: Input Collection (Inversion) → Validation & Initialization → Search Execution → Metric Calculation → Report Rendering → Quality Review.
  • Automatically switch to OFFLINE_IMPORT mode when web_search is unavailable.
  • The plugin itself does not depend on Python; the skill script requires Python 3.11+ and uses only the standard library.
  • Provides optional MCP tool integration examples, allowing registration into ctx.tools in the format mcp__grok_geo__*.

Installation and Activation

Install using DSH:

dsh plugin --profile web add "github:xuboboo/dsh-grok-geo"

Restart DSH after installation for changes to take effect. You can view or uninstall the plugin by navigating to “Settings → Plugin Panel”.

Typical Usage

When scenarios like GEO audit or AI search visibility / citation analysis are mentioned in a conversation, the model will automatically invoke this skill. You can also directly propose a task:

  • “Perform a quick GEO audit for a certain brand (quick mode)”
  • “Analyze the visibility and citations of our brand in ChatGPT / Perplexity / Doubao / DeepSeek”
  • “Compare our brand’s recommendation performance with competitors in AI engines”
  • “Perform a full diagnostic in standard mode”

To validate input examples separately, you can run:

python scripts/validate_input.py --input examples/input.minimal.json --output /tmp/normalized.json

This command reads example input and writes the normalized results to /tmp/normalized.json.

The default run directory is ./geo-audit-runs, which can be overridden by the GEO_AUDIT_RUNS_DIR environment variable.

Optional MCP Integration

By default, the plugin provides grok-geo capabilities as a DSH bundle skill provider. If you wish for tools to be registered into ctx.tools in the format mcp__grok_geo__*, you need to install the optional MCP integration example first:

dsh plugin --profile web add @deepseek-ai/dsh-mcp-client

Use Cases and Notes

This plugin is suitable for scenarios where you need to check the performance of a single brand across multiple AI search engines, for example:

  • Checking brand visibility in engines like ChatGPT / Perplexity / Doubao / DeepSeek
  • Analyzing whether the brand is recommended or cited
  • Comparing competitor recommendation performance in AI engines
  • Discovering content gaps for the brand in AI search scenarios

It is not suitable for:

  • General copywriting
  • Broad SEO keyword research
  • Social media scraping
  • Guaranteeing rankings
  • Content publishing

This plugin inherits the hard rules of the original skill: it never invents search results or citations; when web_search is unavailable, it switches to OFFLINE_IMPORT mode.

Since the plugin runs with the permissions of the current DSH process, it is recommended to review the source code, license, and usage boundaries of the upstream skill before installation.

Conclusion

The value of xuboboo/dsh-grok-geo lies in integrating the grok-geo brand GEO audit capabilities as a DSH bundle plugin, enabling DSH to directly discover, load, and execute the relevant skills.

Related Links:

  • GitHub: https://github.com/xuboboo/dsh-grok-geo
  • Directory Page: Specific directory page address is not provided in verified materials; if you need to search the DSH community directory, you can search for xuboboo/dsh-grok-geo