deepseek-search 0.1.0__tar.gz

deepseek_search-0.1.0/.claude-plugin/marketplace.json

@@ -0,0 +1,15 @@
+{
+  "name": "deepseek_search",
+  "description": "deepseek api websearch能力",
+  "owner": {
+    "name": "8de4732a"
+  },
+  "plugins": [
+    {
+      "name": "deepseek_search",
+      "source": "./plugins/deepseek_search",
+      "description": "deepseek api websearch 能力封装"
+    }
+  ]
+}
+

deepseek_search-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,43 @@
+name: CI
+
+on:
+  push:
+    branches: ["**"]
+    tags-ignore: ["v*"] # tags are handled by publish.yml
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install the project
+        run: uv sync --dev
+
+      - name: Run tests
+        run: uv run pytest -q
+
+      - name: Smoke-build the package
+        run: uv build

deepseek_search-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,92 @@
+name: Publish to PyPI
+
+# Build and publish the deepseek-search package to PyPI whenever a version
+# git tag (matching `v*`) is pushed. Releases use PyPI Trusted Publishing
+# (OIDC), so no long-lived API tokens are stored as secrets.
+#
+# Prerequisite: register this project as a Trusted Publisher on PyPI.
+#   PyPI publishing environment: "pypi"
+#   GitHub repository:          8DE4732A/deepseek-search
+#   Workflow filename:          publish.yml
+#   Environment name:           pypi
+# See: https://docs.pypi.org/trusted-publishers/
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch: # manual run for debugging (still needs the env to publish)
+
+permissions:
+  contents: read
+
+# Cancel a superseded in-flight publish for the same tag.
+concurrency:
+  group: publish-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build sdist + wheel
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # full history so setuptools-scm can resolve the version
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: Install build frontend
+        run: uv tool install build
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Verify the version matches the tag
+        run: |
+          set -euo pipefail
+          TAG="${GITHUB_REF_NAME#v}"
+          PKG_VERSION=$(python -c "import pathlib,glob; \
+            print(pathlib.Path(glob.glob('dist/*.tar.gz')[0]).name.split('-')[1].removesuffix('.tar.gz'))")
+          echo "tag version:   ${TAG}"
+          echo "built version: ${PKG_VERSION}"
+          if [ "${TAG}" != "${PKG_VERSION}" ]; then
+            echo "Version mismatch: tag ${TAG} != package ${PKG_VERSION}" >&2
+            exit 1
+          fi
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/*
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi # required for Trusted Publishing; add reviewers here if desired
+      url: https://pypi.org/project/deepseek-search/
+    permissions:
+      id-token: write # OIDC token for Trusted Publishing
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          attestations: true

deepseek_search-0.1.0/.gitignore

@@ -0,0 +1,36 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.eggs/
+build/
+dist/
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# uv
+.uv-cache/
+
+# Test / coverage output
+.pytest_cache/
+.coverage
+coverage.xml
+htmlcov/
+
+# Local environment and secrets
+.env
+.env.*
+*.local
+
+# OS / editor files
+.DS_Store
+Thumbs.db
+.vscode/
+.idea/
+*.swp
+*.swo

deepseek_search-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 8de4732a
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

deepseek_search-0.1.0/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: deepseek-search
+Version: 0.1.0
+Summary: DeepSeek Anthropic-compatible web search CLI for Claude Code
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/8DE4732A/deepseek-search
+Project-URL: Repository, https://github.com/8DE4732A/deepseek-search
+Project-URL: Issues, https://github.com/8DE4732A/deepseek-search/issues
+Keywords: deepseek,web-search,anthropic,claude-code,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: anthropic>=0.92.0
+Dynamic: license-file
+
+# DeepSeek Search
+
+DeepSeek Search is a Claude Code plugin that wraps DeepSeek's Anthropic-compatible Web Search capability as a local Python CLI and exposes it through a Claude Code skill.
+
+## What it provides
+
+- A `deepseek-search` CLI (Python + [`uv`](https://docs.astral.sh/uv/)), [published on PyPI](https://pypi.org/project/deepseek-search/).
+- DeepSeek API configuration under `~/.deepseek`.
+- A Claude Code skill at `plugins/deepseek_search/skills/deepseek_search/SKILL.md` that tells Claude Code when and how to call the CLI.
+
+## Project layout
+
+```text
+.claude-plugin/marketplace.json
+.github/workflows/          # CI + publish-to-PyPI on `v*` tags
+plugins/deepseek_search/    # Claude Code plugin manifest + skill
+  .claude-plugin/plugin.json
+  skills/deepseek_search/SKILL.md
+src/deepseek_search.py      # CLI implementation
+tests/test_deepseek_search.py
+pyproject.toml
+uv.lock
+```
+
+The Python package lives at the repository root; `plugins/deepseek_search/` holds only the Claude Code plugin manifest and skill instructions.
+
+## Install
+
+The recommended way to use the CLI is as a global `uv` tool:
+
+```bash
+uv tool install deepseek-search
+```
+
+Then `deepseek-search` is available on `PATH` everywhere.
+
+### From source (development)
+
+```bash
+git clone https://github.com/8DE4732A/deepseek-search.git
+cd deepseek-search
+uv sync --dev            # install dependencies
+uv run pytest            # run tests (no API key required)
+```
+
+## Configure DeepSeek
+
+All configuration lives under `~/.deepseek` and is managed through the `config` subcommand. There are **no environment variables** — settings come from the config files or one-off CLI flags.
+
+```bash
+deepseek-search config init                                    # write a default config.json
+deepseek-search config set api_key YOUR_DEEPSEEK_API_KEY       # stored in ~/.deepseek/credentials.json (chmod 600)
+deepseek-search config set model deepseek-v4-pro[1m]           # set any field
+deepseek-search config get model                               # read a single value
+deepseek-search config list                                    # show full effective config (api_key masked)
+```
+
+Configurable keys (type-coerced automatically):
+
+| Key | Stored in | Type |
+|---|---|---|
+| `api_key` | `credentials.json` | string (chmod 600) |
+| `base_url`, `model`, `web_search_tool_type`, `output_format` | `config.json` | string |
+| `max_tokens`, `max_retries` | `config.json` | int |
+| `timeout_seconds` | `config.json` | float |
+| `max_uses`, `allowed_domains`, `blocked_domains` | `config.json` (`search.*`) | int / comma-list |
+
+Advanced search flags (`--model`, `--max-tokens`, `--timeout`, `--max-uses`, `--allowed-domain`, `--blocked-domain`, …) override `config.json` for a single run without writing it back.
+
+## CLI usage
+
+```bash
+deepseek-search --json --query "DeepSeek Claude Code web search documentation"
+deepseek-search "DeepSeek API Claude Code integration"        # bare positional query also works
+deepseek-search search --markdown "DeepSeek API Claude Code integration"
+deepseek-search --help
+```
+
+The JSON output includes:
+
+- `answer`
+- `citations`
+- `warnings`
+- `usage`
+- `model`
+- `request_id`
+- `stop_reason`
+
+## Releasing / publishing
+
+Releases are produced automatically by the **Publish to PyPI** GitHub Action whenever a `v*` git tag is pushed:
+
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+Prerequisites (one-time, in the GitHub repo + PyPI):
+
+1. Register the project as a **Trusted Publisher** on PyPI:
+   - PyPI publishing environment: `pypi`
+   - GitHub repository: `8DE4732A/deepseek-search`
+   - Workflow filename: `publish.yml`
+   - Environment name: `pypi`
+2. No PyPI API token is required — publishing uses OIDC.
+
+The package version is derived from the git tag via `setuptools-scm`, so the workflow fails fast if the tag and the built version disagree.
+
+## License
+
+MIT License. See [LICENSE](LICENSE).

deepseek_search-0.1.0/README.md

@@ -0,0 +1,111 @@
+# DeepSeek Search
+
+DeepSeek Search is a Claude Code plugin that wraps DeepSeek's Anthropic-compatible Web Search capability as a local Python CLI and exposes it through a Claude Code skill.
+
+## What it provides
+
+- A `deepseek-search` CLI (Python + [`uv`](https://docs.astral.sh/uv/)), [published on PyPI](https://pypi.org/project/deepseek-search/).
+- DeepSeek API configuration under `~/.deepseek`.
+- A Claude Code skill at `plugins/deepseek_search/skills/deepseek_search/SKILL.md` that tells Claude Code when and how to call the CLI.
+
+## Project layout
+
+```text
+.claude-plugin/marketplace.json
+.github/workflows/          # CI + publish-to-PyPI on `v*` tags
+plugins/deepseek_search/    # Claude Code plugin manifest + skill
+  .claude-plugin/plugin.json
+  skills/deepseek_search/SKILL.md
+src/deepseek_search.py      # CLI implementation
+tests/test_deepseek_search.py
+pyproject.toml
+uv.lock
+```
+
+The Python package lives at the repository root; `plugins/deepseek_search/` holds only the Claude Code plugin manifest and skill instructions.
+
+## Install
+
+The recommended way to use the CLI is as a global `uv` tool:
+
+```bash
+uv tool install deepseek-search
+```
+
+Then `deepseek-search` is available on `PATH` everywhere.
+
+### From source (development)
+
+```bash
+git clone https://github.com/8DE4732A/deepseek-search.git
+cd deepseek-search
+uv sync --dev            # install dependencies
+uv run pytest            # run tests (no API key required)
+```
+
+## Configure DeepSeek
+
+All configuration lives under `~/.deepseek` and is managed through the `config` subcommand. There are **no environment variables** — settings come from the config files or one-off CLI flags.
+
+```bash
+deepseek-search config init                                    # write a default config.json
+deepseek-search config set api_key YOUR_DEEPSEEK_API_KEY       # stored in ~/.deepseek/credentials.json (chmod 600)
+deepseek-search config set model deepseek-v4-pro[1m]           # set any field
+deepseek-search config get model                               # read a single value
+deepseek-search config list                                    # show full effective config (api_key masked)
+```
+
+Configurable keys (type-coerced automatically):
+
+| Key | Stored in | Type |
+|---|---|---|
+| `api_key` | `credentials.json` | string (chmod 600) |
+| `base_url`, `model`, `web_search_tool_type`, `output_format` | `config.json` | string |
+| `max_tokens`, `max_retries` | `config.json` | int |
+| `timeout_seconds` | `config.json` | float |
+| `max_uses`, `allowed_domains`, `blocked_domains` | `config.json` (`search.*`) | int / comma-list |
+
+Advanced search flags (`--model`, `--max-tokens`, `--timeout`, `--max-uses`, `--allowed-domain`, `--blocked-domain`, …) override `config.json` for a single run without writing it back.
+
+## CLI usage
+
+```bash
+deepseek-search --json --query "DeepSeek Claude Code web search documentation"
+deepseek-search "DeepSeek API Claude Code integration"        # bare positional query also works
+deepseek-search search --markdown "DeepSeek API Claude Code integration"
+deepseek-search --help
+```
+
+The JSON output includes:
+
+- `answer`
+- `citations`
+- `warnings`
+- `usage`
+- `model`
+- `request_id`
+- `stop_reason`
+
+## Releasing / publishing
+
+Releases are produced automatically by the **Publish to PyPI** GitHub Action whenever a `v*` git tag is pushed:
+
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+Prerequisites (one-time, in the GitHub repo + PyPI):
+
+1. Register the project as a **Trusted Publisher** on PyPI:
+   - PyPI publishing environment: `pypi`
+   - GitHub repository: `8DE4732A/deepseek-search`
+   - Workflow filename: `publish.yml`
+   - Environment name: `pypi`
+2. No PyPI API token is required — publishing uses OIDC.
+
+The package version is derived from the git tag via `setuptools-scm`, so the workflow fails fast if the tag and the built version disagree.
+
+## License
+
+MIT License. See [LICENSE](LICENSE).

deepseek_search-0.1.0/plugins/deepseek_search/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "deepseek_search",
+  "version": "0.1.0",
+  "description": "封装deepseek api websearch 能力",
+   "author": {
+    "name": "8de4732a"
+  }
+}
+

deepseek_search-0.1.0/plugins/deepseek_search/skills/deepseek_search/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: deepseek_search
+description: Use DeepSeek API-backed web search for current web information, recent docs, versions, prices, announcements, or explicit web search requests. Returns cited results through a local uv Python CLI.
+---
+
+# DeepSeek Search
+
+Use this skill when the user asks for web search, online/current information, recent documentation, versions, pricing, announcements, news, or any answer that could be stale without checking the web.
+
+Do not use this skill for purely local codebase questions or for private/authenticated pages unless the user has provided a public URL or accessible source.
+
+## Prerequisites (one-time install)
+
+The `deepseek-search` CLI is a global `uv` tool, installed once per machine:
+
+```bash
+uv tool install deepseek-search
+```
+
+Installers from the [PyPI releases](https://pypi.org/project/deepseek-search/) are produced automatically when a `v*` git tag is pushed in the project repository. Once installed, `deepseek-search` is available on `PATH` everywhere (including inside this skill) — no checkout or virtualenv required.
+
+## CLI command
+
+```bash
+deepseek-search --json --query "<specific search query>"
+```
+
+The `search` subcommand is the default, so a bare positional query also works:
+
+```bash
+deepseek-search "<specific search query>"
+deepseek-search search --markdown "<specific search query>"
+```
+
+Use `--markdown` only when you want human-readable output. Prefer `--json` when you need to parse the answer and citations.
+
+If the `deepseek-search` command is not found, ask the user to run `uv tool install deepseek-search`, then retry — do not answer from memory.
+
+## Query guidance
+
+- Make the query specific: include product names, version numbers, dates, and the exact topic.
+- If results are weak or missing, reformulate and search again instead of filling gaps from memory.
+- Preserve source URLs from the CLI output in your final answer.
+- If the CLI reports missing credentials or config, tell the user to configure settings with `deepseek-search config set ...` (see below); do not answer from memory.
+
+## Configuration
+
+All configuration lives under `~/.deepseek`:
+
+- `~/.deepseek/config.json` — non-sensitive settings (model, base_url, max_tokens, timeout_seconds, max_retries, web_search_tool_type, output_format, and `search.*` fields max_uses / allowed_domains / blocked_domains).
+- `~/.deepseek/credentials.json` — the API key (chmod 0600).
+
+There are **no environment variables**. Settings come from the config files or from one-off CLI flags. Manage them with the `config` subcommand:
+
+```bash
+deepseek-search config init                          # write a default config.json
+deepseek-search config set model deepseek-v4-flash # set any field
+deepseek-search config set api_key YOUR_DEEPSEEK_API_KEY   # stored in credentials.json, chmod 0600
+deepseek-search config get model                    # read a single value
+deepseek-search config list                         # show full effective config (api_key masked)
+```
+
+Keys map 1:1 to the settings above; values are type-coerced (int for max_tokens/max_uses/max_retries, float for timeout_seconds, comma-list for allowed_domains/blocked_domains). Unknown keys are rejected.
+
+## Interpreting output
+
+The JSON output contains:
+
+- `answer`: model-generated answer grounded in web search.
+- `citations`: extracted source URLs/titles/snippets when available.
+- `warnings`: compatibility or completeness notes.
+- `usage`, `model`, `request_id`, and `stop_reason`: debugging metadata.
+
+Base your response on `answer` and `citations`. If `warnings` says the result is incomplete, say that plainly.

deepseek_search-0.1.0/pyproject.toml

@@ -0,0 +1,56 @@
+[project]
+name = "deepseek-search"
+description = "DeepSeek Anthropic-compatible web search CLI for Claude Code"
+readme = "README.md"
+requires-python = ">=3.11"
+dynamic = ["version"]
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["deepseek", "web-search", "anthropic", "claude-code", "cli"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Internet :: WWW/HTTP :: Indexing/Search",
+  "Topic :: Software Development :: Libraries",
+]
+dependencies = [
+  "anthropic>=0.92.0",
+]
+
+[project.scripts]
+deepseek-search = "deepseek_search:main"
+
+[project.urls]
+Homepage = "https://github.com/8DE4732A/deepseek-search"
+Repository = "https://github.com/8DE4732A/deepseek-search"
+Issues = "https://github.com/8DE4732A/deepseek-search/issues"
+
+[dependency-groups]
+dev = [
+  "pytest>=8.0",
+]
+
+[build-system]
+requires = ["setuptools>=68", "setuptools-scm>=8"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+py-modules = ["deepseek_search"]
+
+[tool.setuptools.package-dir]
+"" = "src"
+
+[tool.setuptools_scm]
+# Derive the package version from git tags (e.g. v0.1.0 -> 0.1.0).
+# CI sets this explicitly when building from a published tag.
+local_scheme = "no-local-version"
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]

deepseek_search-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+