Skip to content

Latest commit

 

History

History
21 lines (14 loc) · 2.89 KB

README.md

File metadata and controls

21 lines (14 loc) · 2.89 KB

BeatAPI plugins for DeepSeek Harness

Five independently installable bundles with distinct tools and tasks:

Bundle Task Tools Install
Social Research Social discovery, approved reads, stored results and source tables 5 native dsh plugin --profile web add @beatapi/dsh-social@0.1.1
Media Kit Image/video discovery, pricing previews, approved starts and task status 4 native dsh plugin --profile web add @beatapi/dsh-media@0.1.1
BeatBrowser Existing Chrome logins and owned background TaskSpaces 24 namespaced MCP tools dsh plugin --profile web add @beatapi/dsh-browser@0.1.1
BeatDesign Local creative Project, Canvas, Assets and Timeline 30 namespaced MCP tools dsh plugin --profile web add @beatapi/dsh-design
BeatGEO Existing local brand, evidence and SEO/GEO workspace Setup diagnostic plus the product’s permitted MCP tools dsh plugin --profile web add @beatapi/dsh-geo

The packages do not restrict Harness versions. Tested hosts: 0.1.0-rc.6, 0.2.1-rc.2, and 0.2.1-rc.5. Future hosts are not yet tested and may introduce breaking changes. Node.js 22.12+. Community integrations by BeatAPI, not official DeepSeek products. Each bundle supplies a Skill and coexists with the others. Prebuilt JavaScript needs no install-time build script. Each package README documents GitHub installation too.

harness/shared/ is synchronized into self-contained Social and Media packages by npm run harness:sync; npm run harness:check checks drift and offline behavior. To verify a host, run node harness/scripts/host-smoke.mjs /absolute/path/to/@deepseek-ai/dsh. It installs all three tarballs into a temporary profile, checks 33 tool registrations and three Skills, calls the report tool, then stops the host and removes temporary data. It never creates paid tasks or mutates existing profiles.

See validation and security for evidence and limits.

For a reproducible test runtime, first run node harness/scripts/install-host.mjs <version> /tmp/beatapi-dsh-host. Its recorded official package versions avoid older prerelease caret ranges resolving a mixture of later RC packages. These pins affect the test host only, not the distributed plugins or the user's installation.

BeatDesign starts its pinned published runtime; port 3020 must be free. BeatGEO requires an already-running local product and a scoped workspace MCP key; it does not duplicate the product’s BeatAPI connection. SEO is accessed in the same brand dashboard, not an invented MCP query catalog. See each package README for first-use setup. workspace-smoke.mjs checks a real isolated BeatDesign runtime; geo-smoke.mjs checks authenticated proxying, read-only catalog and missing-key behavior with labeled synthetic MCP data.