Get started

BioResearcher is an Agent Skills package: any harness that reads SKILL.md can load it. Pick your channel below — the biomedical MCP server (biomcp) is required for the research skills and can be bootstrapped automatically by the onboarding skill.

Requirements

Node.js	>= 22.13 with npx on PATH (npx --version)
Optional	uv + python3 — the plotting and weekly-parsing skills bootstrap their own Python dependencies
API keys	None required by default (see FAQ)

Install channels

A · skills CLI (any harness)

Works with opencode, Claude Code, Codex, Cursor, Gemini CLI and every SKILL.md reader. Add just the onboarding skill to bootstrap the MCP runtime automatically.

npx skills add yeyuan98/bioresearcher-skills
# bootstrap the runtime immediately:
npx skills add yeyuan98/bioresearcher-skills --skill bioresearcher-onboard

B · Claude Code plugin marketplace

Bundles the pinned biomcp MCP server (auto-starts, no manual .mcp.json) plus the deep-research worker subagent.

/plugin marketplace add yeyuan98/bioresearcher-skills
/plugin install bioresearcher@bioresearcher-skills

C · WorkBuddy connector market

One market install: MCP server (npmmirror registry, managed Node 22) + four skills with Chinese/English descriptions. Search for “BioResearcher 生物医学研究”.

# WorkBuddy -> connector market -> BioResearcher 生物医学研究 -> install

D · git clone

Clone into the skills directory your harness reads (.opencode/skills/, .claude/skills/, .agents/skills/, .codex/skills/, .gemini/skills/).

git clone https://github.com/yeyuan98/bioresearcher-skills .opencode/skills/bioresearcher-skills

Mainland-China networks

The onboarding skill auto-detects network conditions and switches to the npmmirror registry for Node and biomcp downloads; the uv skill supports China PyPI mirrors; the WorkBuddy connector uses npmmirror by default. Upstream biomedical APIs (NCBI, ClinicalTrials.gov, MyGene…) are global endpoints — set HTTP(S)_PROXY on restricted networks.

Verify the server

Diagnostics only (never starts the server); exit code 0 = healthy.

npx -y biomcp@1.1.1 doctor --client opencode

Full onboarding chapter (manual wiring, permissions, timeouts): agent doc §5