# Send PubMed Search to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "pubmed-search-skill",
    "name": "PubMed Search",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/JackKuo666/pubmed-search-skill",
    "canonicalUrl": "https://clawhub.ai/JackKuo666/pubmed-search-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/pubmed-search-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=pubmed-search-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "pubmed_search.py",
      "requirements.txt"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/pubmed-search-skill"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/pubmed-search-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/pubmed-search-skill",
    "agentUrl": "https://openagent3.xyz/skills/pubmed-search-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/pubmed-search-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/pubmed-search-skill/agent.md"
  }
}
```
## Documentation

### Article Search

Search PubMed articles using keywords
Advanced search with multiple filters (title, author, journal, date range)
Fast access to comprehensive paper metadata

### Metadata Retrieval

Fetch detailed metadata for specific papers using PMID
Extract title, authors, abstract, journal, publication date
Support for batch retrieval

### Paper Analysis

Deep analysis of PubMed articles
Research background and significance
Methodology overview and key findings
Limitations and future research directions

### Full-Text Access

Attempt to download full-text PDF content
Check open access availability via PubMed Central (PMC)
Provide direct links to articles

### Prerequisites

Python 3.8+
pip package manager

### Setup Steps

Install Python dependencies (choose one method):
Method 1: Using uv (Recommended - Fastest)
# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# Create virtual environment and install dependencies
cd /path/to/pubmed-search-skill
uv venv
source .venv/bin/activate  # Linux/macOS
# or .venv\\Scripts\\activate  # Windows
uv pip install -r requirements.txt

Method 2: Using conda (Best for scientific/research users)
cd /path/to/pubmed-search-skill
conda create -n pubmed-search python=3.11 -y
conda activate pubmed-search
pip install -r requirements.txt

Method 3: Using pip directly (Built-in, no extra installation)
cd /path/to/pubmed-search-skill
pip install -r requirements.txt



Configure API credentials (optional for basic search, required for PDF download):
# Copy example configuration
cp .env.example .env

# Edit .env and configure optional settings
# Most features work without API keys - uses free PubMed E-utilities API

### Verify Installation

python pubmed_search.py --help

### How to Use

When users request literature search or analysis:

Understand requirements: Ask what research topic or papers to search for
Choose method:

Simple keyword search for quick results
Advanced search with specific filters
Deep analysis for comprehensive understanding


Execute search:
python pubmed_search.py search --keywords "CRISPR gene editing" --results 10


Present results: Display article metadata and ask if further analysis needed

### Basic Keyword Search

# Search for articles by keywords
python pubmed_search.py search --keywords "COVID-19 vaccine efficacy" --results 10

### Advanced Search

# Search with multiple filters
python pubmed_search.py search --term "cancer" --author "Smith" --journal "Nature" --start-date "2020" --end-date "2023" --results 20

### Get Article Metadata

# Fetch detailed metadata for a specific paper
python pubmed_search.py metadata --pmid "12345678"

### Deep Paper Analysis

# Perform comprehensive analysis of a paper
python pubmed_search.py analyze --pmid "12345678" --output analysis.md

### Download Full-Text PDF

# Attempt to download open access PDF
python pubmed_search.py download --pmid "12345678" --output ./papers/

### Batch Search

# Search and save results to file
python pubmed_search.py search --keywords "Alzheimer disease" --results 50 --output results.json

### Environment Variables (Optional)

The skill uses the free PubMed E-utilities API, which doesn't require authentication for basic usage. However, you can configure these optional settings:

PUBMED_API_KEY: PubMed API key for higher rate limits (get from: https://www.ncbi.nlm.nih.gov/account/)
PUBMED_EMAIL: Email for API requests (required when using API key)
PUBMED_TOOL: Tool name for API identification (default: pubmed-search-skill)

### Rate Limits

Without API key: 3 requests per second
With API key: Up to 10 requests per second

Get your free API key at: https://www.ncbi.nlm.nih.gov/account/

### Best Practices

Use specific keywords for better results
Apply filters (author, journal, date) to narrow down searches
Review abstracts before requesting full analysis
Check open access availability before downloading PDFs
Cite original papers when using retrieved information

### Console Output

Human-readable format with key article information

### JSON Format

Machine-readable format for further processing:

[
  {
    "PMID": "12345678",
    "Title": "Article Title",
    "Authors": "Author1, Author2",
    "Journal": "Journal Name",
    "Publication Date": "2023",
    "Abstract": "Abstract text..."
  }
]

### Markdown Format

Formatted output for documentation:

# Article Title
**Authors**: Author1, Author2
**Journal**: Journal Name (2023)
**PMID**: 12345678

## Abstract
Abstract text...

### Notes

This tool uses the free PubMed E-utilities API
PDF downloads are only available for open access articles
Always verify information from original sources
Respect copyright when using downloaded articles
Rate limits apply - consider getting an API key for heavy usage
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: JackKuo666
- Version: 0.1.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/pubmed-search-skill)
- [Send to Agent page](https://openagent3.xyz/skills/pubmed-search-skill/agent)
- [JSON manifest](https://openagent3.xyz/skills/pubmed-search-skill/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/pubmed-search-skill/agent.md)
- [Download page](https://openagent3.xyz/downloads/pubmed-search-skill)