@wentorai/research-plugins 1.4.2 → 1.4.3

package/README.en.md

@@ -0,0 +1,143 @@
+<div align="center">
+
+<img src="assets/logo.png" width="160" alt="Research-Claw · 科研龙虾" />
+
+# The most comprehensive library of AI skills&plugins for academic research
+
+**The brain of Research-Claw — 438 academic skills + 34 API tools**
+
+Plug-and-play research capabilities for [Research-Claw](https://github.com/wentorai/Research-Claw) and 40+ AI agent frameworks
+
+[![npm](https://img.shields.io/npm/v/@wentorai/research-plugins?style=flat-square&color=EF4444&logo=npm)](https://www.npmjs.com/package/@wentorai/research-plugins)
+[![License](https://img.shields.io/badge/license-MIT-3B82F6?style=flat-square)](LICENSE)
+[![Skills](https://img.shields.io/badge/skills-438-EF4444?style=flat-square)](https://www.npmjs.com/package/@wentorai/research-plugins)
+[![Tools](https://img.shields.io/badge/API_tools-34-3B82F6?style=flat-square)](#agent-tools-34)
+
+[🌐 wentor.ai](https://wentor.ai) · [🇨🇳 中文](README.md) · [🦞 Research-Claw](https://github.com/wentorai/Research-Claw) · [🪲 Issues](https://github.com/wentorai/research-plugins/issues)
+
+</div>
+
+---
+
+## Quick Start
+
+### Install (Research-Claw / OpenClaw)
+
+```bash
+openclaw plugins install @wentorai/research-plugins
+```
+
+Installs to `~/.openclaw/extensions/`. Restart the gateway to auto-load all skills + tools.
+
+### Install (Claude Code / Cursor / Windsurf / OpenCode)
+
+```bash
+npx skills add wentorai/research-plugins
+```
+
+> This installs SKILL.md files only (no API tools). Compatible with 41 agent frameworks supporting the skills protocol.
+
+### Uninstall
+
+```bash
+# OpenClaw / Research-Claw — manually remove plugin directory
+rm -rf ~/.openclaw/extensions/research-plugins
+
+# npx skills — manually remove skills directory
+rm -rf .skills/wentorai/research-plugins
+```
+
+> **pnpm projects:** Do not add this as a pnpm dependency and load from `node_modules` via `plugins.load.paths`. pnpm hardlinks are rejected by OpenClaw's security validator. Always use `openclaw plugins install`.
+
+---
+
+## What's Inside
+
+### Academic Skills (438)
+
+Structured SKILL.md guides covering the full research lifecycle, loaded on demand:
+
+| Category | Count | Coverage |
+|:--|:--|:--|
+| **Literature** | 87 | Multi-database search · Citation tracking · Full-text · Open access |
+| **Methodology** | 79 | DID · RDD · IV · Meta-analysis · Systematic review · Grant writing |
+| **Data Analysis** | 68 | Python · R · STATA · Visualization · Panel data · Econometrics |
+| **Writing** | 74 | Paper sections · LaTeX · References · Rebuttal generation |
+| **Domains** | 93 | 16 disciplines: CS · AI/ML · Biomedical · Economics · Law · Physics etc. |
+| **Tools** | 51 | Diagrams · PDF parsing · Knowledge graphs · OCR · Scraping |
+
+Skills use **progressive disclosure**: 6 category entries → 40 subcategory indexes → 438 concrete skills. Agents load on demand, never injecting everything at once.
+
+### Agent Tools (34)
+
+TypeScript wrappers for 18 free academic database APIs, auto-registered as OpenClaw plugin tools:
+
+| Module | Tools | Source |
+|:--|:--|:--|
+| `openalex` | `search_openalex` · `get_work` · `get_author_openalex` | OpenAlex (250M+ works) |
+| `crossref` | `resolve_doi` · `search_crossref` | CrossRef (150M+ DOIs) |
+| `arxiv` | `search_arxiv` · `get_arxiv_paper` | arXiv |
+| `pubmed` | `search_pubmed` · `get_article` | PubMed / NCBI |
+| `unpaywall` | `find_oa_version` | Unpaywall (open access) |
+| `europe-pmc` | `search_europe_pmc` · `get_epmc_citations` · `get_epmc_references` | Europe PMC (33M+) |
+| `opencitations` | `get_citations_open` · `get_references_open` · `get_citation_count` | OpenCitations (2B+ links) |
+| `dblp` | `search_dblp` · `search_dblp_author` | DBLP (7M+ CS records) |
+| `doaj` | `search_doaj` | DOAJ (9M+ OA articles) |
+| `biorxiv` | `search_biorxiv` · `search_medrxiv` · `get_preprint_by_doi` | bioRxiv / medRxiv |
+| `openaire` | `search_openaire` | OpenAIRE (170M+, EU funder filter) |
+| `zenodo` | `search_zenodo` · `get_zenodo_record` | Zenodo |
+| `orcid` | `search_orcid` · `get_orcid_works` | ORCID |
+| `inspire-hep` | `search_inspire` · `get_inspire_paper` | INSPIRE-HEP (physics) |
+| `hal` | `search_hal` | HAL (French open archive) |
+| `osf-preprints` | `search_osf_preprints` | OSF Preprints |
+| `datacite` | `search_datacite` · `resolve_datacite_doi` | DataCite (dataset DOIs) |
+| `ror` | `search_ror` | ROR (research organizations) |
+
+### Curated Resources (6)
+
+Hand-picked resource collections for each skill category. See `curated/` directory.
+
+---
+
+## Architecture
+
+```
+@wentorai/research-plugins
+├── skills/                    ← 438 SKILL.md (6 categories × 40 subcategories)
+│   ├── literature/            ← Search, discovery, full-text, metadata
+│   ├── writing/               ← Composition, citation, LaTeX, polish
+│   ├── analysis/              ← Statistics, econometrics, dataviz
+│   ├── research/              ← Methodology, reviews, grants
+│   ├── domains/               ← 16 academic disciplines
+│   └── tools/                 ← Diagrams, documents, scraping, OCR
+├── src/tools/                 ← 34 API tools (18 modules)
+├── curated/                   ← 6 curated resource lists
+├── catalog.json               ← Full index (462 entries)
+├── index.ts                   ← Plugin entry (OpenClaw Plugin SDK)
+└── openclaw.plugin.json       ← Plugin manifest
+```
+
+**Loading modes:**
+- **Research-Claw / OpenClaw**: Full plugin (skills + API tools) via `openclaw plugins install`
+- **Other agent frameworks**: SKILL.md files only (no API tools) via `npx skills add`
+
+---
+
+## Community Attribution
+
+This project curates, organizes, and enhances publicly available academic resources.
+
+- **Skills** are authored guides based on established research methodologies, public API docs, and widely-used workflows. Where content derives from specific projects, the `source` field in each SKILL.md frontmatter links to the original.
+- **Curated lists** aggregate community resource links for discovery purposes.
+
+All original content is released under the [MIT License](LICENSE). Referenced third-party projects retain their own licenses.
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+[MIT](LICENSE) — Copyright (c) 2026 Wentor AI

package/README.md

@@ -1,176 +1,143 @@
-# @wentorai/research-plugins
+<div align="center">
 
-**[English](#english)** | **[中文](#中文)**
+<img src="assets/logo.png" width="160" alt="科研龙虾 · Research-Claw" />
 
----
-
-<a id="english"></a>
-
-## Research Plugins for Research-Claw
-
-An open-source collection of **438 academic research skills**, **34 agent tools** (18 API modules), and **6 curated resource lists** for [Research-Claw](https://wentor.ai) and other AI coding agents.
-
-Built by [Wentor AI](https://wentor.ai) for the global research community.
+# 最全的学术科研领域技能插件库
 
-### What's Inside
+**科研龙虾的大脑 — 438 个学术技能 + 34 个 API 工具**
 
-| Component | Count | Description |
-|-----------|-------|-------------|
-| **Skills** | 438 | Practical SKILL.md guides covering literature search, academic writing, data analysis, research methods, 16 domain specialties, and productivity tools |
-| **Agent Tools** | 34 | TypeScript API wrappers for 18 academic databases: OpenAlex, CrossRef, arXiv, PubMed, Unpaywall, Europe PMC, OpenCitations, DOAJ, DBLP, bioRxiv/medRxiv, OpenAIRE, Zenodo, ORCID, INSPIRE-HEP, HAL, OSF, DataCite, ROR |
-| **Curated Lists** | 6 | Hand-picked resource collections for each skill category |
+为 [Research-Claw (科研龙虾)](https://github.com/wentorai/Research-Claw) 及 40+ AI Agent 框架提供即插即用的科研能力
 
-> **Note:** 150 MCP server configs were archived in the v1.4.0 audit. See `archived/mcp-configs/` for reference.
+[![npm](https://img.shields.io/npm/v/@wentorai/research-plugins?style=flat-square&color=EF4444&logo=npm)](https://www.npmjs.com/package/@wentorai/research-plugins)
+[![License](https://img.shields.io/badge/license-MIT-3B82F6?style=flat-square)](LICENSE)
+[![Skills](https://img.shields.io/badge/skills-438-EF4444?style=flat-square)](https://www.npmjs.com/package/@wentorai/research-plugins)
+[![Tools](https://img.shields.io/badge/API_tools-34-3B82F6?style=flat-square)](#智能体工具34-个)
 
-### Taxonomy
+[🌐 wentor.ai](https://wentor.ai) · [🇬🇧 English](README.en.md) · [🦞 Research-Claw](https://github.com/wentorai/Research-Claw) · [🪲 Issues](https://github.com/wentorai/research-plugins/issues)
 
-Skills are organized into **6 categories** with **40 subcategories**:
+</div>
 
-| Category | Subcategories | Skills | Description |
-|----------|---------------|--------|-------------|
-| **literature** | search, discovery, fulltext, metadata | 80 | Paper search, citation tracking, open access |
-| **writing** | composition, polish, latex, templates, citation | 64 | Academic writing, LaTeX, reference management |
-| **analysis** | statistics, econometrics, wrangling, dataviz | 46 | Statistical methods, data cleaning, visualization |
-| **research** | methodology, deep-research, paper-review, automation, funding | 53 | Research design, systematic reviews, grant writing |
-| **domains** | 16 disciplines (CS, AI/ML, biomedical, chemistry, economics, finance, law, physics, math, ecology, etc.) | 147 | Domain-specific research methods and tools |
-| **tools** | diagram, document, code-exec, scraping, knowledge-graph, ocr-translate | 48 | Diagrams, PDF parsing, reproducible code, OCR |
+---
 
-### Install
+## 快速开始
 
-#### As OpenClaw Plugin (Recommended)
+### 安装（Research-Claw / OpenClaw 用户）
 
 ```bash
 openclaw plugins install @wentorai/research-plugins
 ```
 
-This installs the plugin to `~/.openclaw/extensions/` where OpenClaw auto-discovers it. Skills and agent tools are loaded automatically.
-
-> **Note for satellite/pnpm projects:** Do not add this package as a `pnpm` dependency and load it from `node_modules` via `plugins.load.paths`. pnpm's content-addressable store uses hardlinks, which OpenClaw's security validator rejects (`unsafe plugin manifest path`). Always use `openclaw plugins install` instead.
+插件安装到 `~/.openclaw/extensions/`，重启 gateway 后自动加载所有技能 + 工具。
 
-#### As Skills Collection (Claude Code, Cursor, Windsurf, OpenCode)
+### 安装（Claude Code / Cursor / Windsurf / OpenCode 用户）
 
 ```bash
 npx skills add wentorai/research-plugins
 ```
 
-#### Via npm
-
-```bash
-npm install @wentorai/research-plugins
-```
-
-### Agent Tools
-
-34 tool functions across 18 academic API modules, registered automatically when used as an OpenClaw plugin. All APIs are free and open:
-
-| Module | Tools | API |
-|--------|-------|-----|
-| `openalex` | `search_openalex`, `get_work`, `get_author_openalex` | OpenAlex (250M+ works) |
-| `crossref` | `resolve_doi`, `search_crossref` | CrossRef (150M+ DOIs) |
-| `arxiv` | `search_arxiv`, `get_arxiv_paper` | arXiv |
-| `pubmed` | `search_pubmed`, `get_article` | PubMed / NCBI |
-| `unpaywall` | `find_oa_version` | Unpaywall |
-| `europe-pmc` | `search_europe_pmc`, `get_epmc_citations`, `get_epmc_references` | Europe PMC (33M+) |
-| `opencitations` | `get_citations_open`, `get_references_open`, `get_citation_count` | OpenCitations (2B+ links) |
-| `doaj` | `search_doaj` | DOAJ (9M+ OA articles) |
-| `dblp` | `search_dblp`, `search_dblp_author` | DBLP (7M+ CS records) |
-| `biorxiv` | `search_biorxiv`, `search_medrxiv`, `get_preprint_by_doi` | bioRxiv / medRxiv |
-| `openaire` | `search_openaire` | OpenAIRE (170M+, EU funder filter) |
-| `zenodo` | `search_zenodo`, `get_zenodo_record` | Zenodo |
-| `orcid` | `search_orcid`, `get_orcid_works` | ORCID |
-| `inspire-hep` | `search_inspire`, `get_inspire_paper` | INSPIRE-HEP (physics) |
-| `hal` | `search_hal` | HAL (French open archive) |
-| `osf-preprints` | `search_osf_preprints` | OSF Preprints |
-| `datacite` | `search_datacite`, `resolve_datacite_doi` | DataCite (dataset DOIs) |
-| `ror` | `search_ror` | ROR (research organizations) |
-
-### Community Attribution
-
-This project curates, organizes, and enhances publicly available academic resources from across the open-source ecosystem. We are grateful to the researchers, developers, and open-source communities whose work makes this collection possible.
-
-- **Skills** are authored guides based on established research methodologies, public API documentation, and widely-used academic workflows. Where content is derived from specific open-source projects, the `source` field in each SKILL.md frontmatter links to the original.
-- **Curated Lists** aggregate links to community resources and are provided for discovery purposes.
+> 此方式仅安装 SKILL.md 技能文件（无 API 工具），适用于 41 个支持 skills 协议的 Agent 框架。
 
-All original content in this repository is released under the [MIT License](LICENSE). Third-party projects referenced retain their own licenses.
+### 卸载
 
-### Contributing
-
-See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on adding skills and curated resources.
+```bash
+# OpenClaw / Research-Claw — 手动删除插件目录
+rm -rf ~/.openclaw/extensions/research-plugins
 
-### License
+# npx skills — 手动删除技能目录
+rm -rf .skills/wentorai/research-plugins
+```
 
-[MIT](LICENSE) -- Copyright (c) 2026 Wentor AI
+> **pnpm 项目注意**：请勿将本包作为 `pnpm` 依赖并通过 `plugins.load.paths` 从 `node_modules` 加载。pnpm 的硬链接机制会被 OpenClaw 安全校验拒绝 (`unsafe plugin manifest path`)。请始终使用 `openclaw plugins install`。
 
 ---
 
-<a id="中文"></a>
-
-## Research-Claw 科研插件集
-
-一个开源的学术科研资源集合，包含 **438 个科研技能**、**34 个智能体工具**（18 个 API 模块）和 **6 个精选资源列表**，为 [Research-Claw (科研龙虾)](https://wentor.ai) 及其他 AI 编程助手而构建。
-
-由 [Wentor AI](https://wentor.ai) 为全球科研社区打造。
-
-### 包含内容
-
-| 组件 | 数量 | 说明 |
-|------|------|------|
-| **技能 (Skills)** | 438 | 涵盖文献检索、学术写作、数据分析、研究方法、16 个学科领域及生产力工具的实用指南 |
-| **智能体工具** | 34 | 封装 18 个学术数据库 API 的 TypeScript 工具：OpenAlex、CrossRef、arXiv、PubMed、Unpaywall、Europe PMC、OpenCitations、DOAJ、DBLP、bioRxiv/medRxiv、OpenAIRE、Zenodo、ORCID、INSPIRE-HEP、HAL、OSF、DataCite、ROR |
-| **精选列表** | 6 | 按分类整理的优质资源推荐 |
-
-> **注意**：150 个 MCP 服务器配置已在 v1.4.0 审计中归档。参见 `archived/mcp-configs/`。
-
-### 分类体系
+## 包含什么
+
+### 学术技能（438 个）
+
+覆盖科研全流程的结构化 SKILL.md 指南，按需自动加载：
+
+| 类别 | 技能数 | 覆盖范围 |
+|:--|:--|:--|
+| **文献** (literature) | 87 | 多库联搜 · 引文追踪 · 全文获取 · 开放获取 |
+| **研究方法** (research) | 79 | DID · RDD · IV · 元分析 · 系统综述 · 基金申请 |
+| **数据分析** (analysis) | 68 | Python · R · STATA · 可视化 · 面板数据 · 计量经济 |
+| **学术写作** (writing) | 74 | 论文各章节 · LaTeX · 参考文献 · 审稿意见回复 |
+| **学科领域** (domains) | 93 | 16 个学科：CS · AI/ML · 生物医学 · 经济 · 法学 · 物理 等 |
+| **效率工具** (tools) | 51 | 流程图 · PDF 解析 · 知识图谱 · OCR · 爬虫 |
+
+技能通过 **渐进式加载** 机制工作：6 个类别入口 → 40 个子分类索引 → 438 个具体技能。Agent 按需加载，不会一次性注入全部内容。
+
+### 智能体工具（34 个）
+
+直连 18 个免费学术数据库 API 的 TypeScript 工具，作为 OpenClaw 插件自动注册：
+
+| 模块 | 工具 | 数据源 |
+|:--|:--|:--|
+| `openalex` | `search_openalex` · `get_work` · `get_author_openalex` | OpenAlex (250M+ 作品) |
+| `crossref` | `resolve_doi` · `search_crossref` | CrossRef (150M+ DOI) |
+| `arxiv` | `search_arxiv` · `get_arxiv_paper` | arXiv |
+| `pubmed` | `search_pubmed` · `get_article` | PubMed / NCBI |
+| `unpaywall` | `find_oa_version` | Unpaywall (开放获取) |
+| `europe-pmc` | `search_europe_pmc` · `get_epmc_citations` · `get_epmc_references` | Europe PMC (33M+) |
+| `opencitations` | `get_citations_open` · `get_references_open` · `get_citation_count` | OpenCitations (2B+ 引用) |
+| `dblp` | `search_dblp` · `search_dblp_author` | DBLP (7M+ CS 文献) |
+| `doaj` | `search_doaj` | DOAJ (9M+ OA 文章) |
+| `biorxiv` | `search_biorxiv` · `search_medrxiv` · `get_preprint_by_doi` | bioRxiv / medRxiv |
+| `openaire` | `search_openaire` | OpenAIRE (170M+, EU 资助筛选) |
+| `zenodo` | `search_zenodo` · `get_zenodo_record` | Zenodo |
+| `orcid` | `search_orcid` · `get_orcid_works` | ORCID |
+| `inspire-hep` | `search_inspire` · `get_inspire_paper` | INSPIRE-HEP (高能物理) |
+| `hal` | `search_hal` | HAL (法国开放档案) |
+| `osf-preprints` | `search_osf_preprints` | OSF Preprints |
+| `datacite` | `search_datacite` · `resolve_datacite_doi` | DataCite (数据集 DOI) |
+| `ror` | `search_ror` | ROR (研究机构) |
 
-技能按 **6 大类别** 和 **40 个子分类** 组织：
+### 精选资源（6 套）
 
-| 类别 | 子分类 | 技能数 | 覆盖范围 |
-|------|--------|--------|---------|
-| **文献 (literature)** | 检索、发现、全文获取、元数据 | 80 | 论文搜索、引文追踪、开放获取 |
-| **写作 (writing)** | 写作、润色、LaTeX、模板、引用 | 64 | 学术写作、LaTeX 排版、参考文献管理 |
-| **分析 (analysis)** | 统计、计量经济、数据处理、可视化 | 46 | 统计方法、数据清洗、图表制作 |
-| **研究 (research)** | 方法论、深度研究、论文评审、自动化、基金 | 53 | 研究设计、系统综述、基金申请 |
-| **学科 (domains)** | 16 个学科方向 | 147 | 各学科专属研究方法与工具 |
-| **工具 (tools)** | 图表、文档、代码执行、爬虫、知识图谱、OCR | 48 | 流程图、PDF 解析、可复现代码、OCR 翻译 |
+每个技能类别附带一套手工精选的优质资源列表，见 `curated/` 目录。
 
-### 安装方式
+---
 
-#### 作为 OpenClaw 插件（推荐）
+## 架构
 
-```bash
-openclaw plugins install @wentorai/research-plugins
 ```
-
-插件会安装到 `~/.openclaw/extensions/`，OpenClaw 自动发现并加载所有技能和工具。
-
-> **pnpm 项目注意**：请勿将本包作为 `pnpm` 依赖并通过 `plugins.load.paths` 从 `node_modules` 加载。pnpm 的内容寻址存储使用硬链接 (nlink > 1)，会被 OpenClaw 安全校验拒绝 (`unsafe plugin manifest path`)。请始终使用 `openclaw plugins install`。
-
-#### 作为技能集合 (Claude Code, Cursor, Windsurf, OpenCode)
-
-```bash
-npx skills add wentorai/research-plugins
+@wentorai/research-plugins
+├── skills/                    ← 438 SKILL.md (6 类别 × 40 子分类)
+│   ├── literature/            ← 文献检索/追踪/获取
+│   ├── writing/               ← 学术写作/引用/LaTeX
+│   ├── analysis/              ← 数据分析/统计/可视化
+│   ├── research/              ← 研究方法/综述/基金
+│   ├── domains/               ← 16 学科领域
+│   └── tools/                 ← 效率工具/图表/OCR
+├── src/tools/                 ← 34 API 工具 (18 模块)
+├── curated/                   ← 6 套精选资源列表
+├── catalog.json               ← 全量索引 (462 entries)
+├── index.ts                   ← 插件入口 (OpenClaw Plugin SDK)
+└── openclaw.plugin.json       ← 插件清单
 ```
 
-#### 通过 npm
+**加载方式**：
+- **Research-Claw / OpenClaw**：作为完整插件加载（技能 + API 工具），通过 `openclaw plugins install`
+- **其他 Agent 框架**：仅加载 SKILL.md 文件（无 API 工具），通过 `npx skills add`
 
-```bash
-npm install @wentorai/research-plugins
-```
+---
 
-### 社区致谢与声明
+## 社区致谢
 
-本项目对互联网上公开可用的学术资源进行了遴选、整理和增强。我们感谢所有使这个集合成为可能的研究者、开发者和开源社区。
+本项目对互联网上公开可用的学术资源进行了遴选、整理和增强。
 
-- **技能** 是基于成熟研究方法、公开 API 文档和广泛使用的学术工作流编写的实用指南。凡内容源自特定开源项目的，每个 SKILL.md 的 frontmatter 中 `source` 字段均标注了原始链接。
-- **精选列表** 汇集社区资源链接，仅供发现和参考之用。
+- **技能** 基于成熟研究方法、公开 API 文档和广泛使用的学术工作流编写。凡内容源自特定开源项目的，SKILL.md frontmatter 中 `source` 字段标注了原始链接。
+- **精选列表** 汇集社区资源链接，仅供发现和参考。
 
-本仓库中的所有原创内容均以 [MIT 许可证](LICENSE) 发布。引用的第三方项目保留其各自的许可证。
+所有原创内容以 [MIT 许可证](LICENSE) 发布。引用的第三方项目保留各自许可证。
+
+---
 
-### 参与贡献
+## 贡献
 
-请查阅 [CONTRIBUTING.md](CONTRIBUTING.md) 了解添加技能和精选资源的指南。
+请查阅 [CONTRIBUTING.md](CONTRIBUTING.md) 了解添加技能和资源的指南。
 
-### 许可证
+## 许可证
 
-[MIT](LICENSE) -- Copyright (c) 2026 Wentor AI
+[MIT](LICENSE) — Copyright (c) 2026 Wentor AI

package/openclaw.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "research-plugins",
-  "version": "1.4.0",
+  "version": "1.4.3",
   "name": "Research Plugins",
   "description": "438 academic research skills, 34 agent tools across 18 API modules & 6 curated lists for Research-Claw",
   "skills": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wentorai/research-plugins",
-  "version": "1.4.2",
+  "version": "1.4.3",
   "type": "module",
   "description": "438 academic research skills, 34 agent tools across 18 API modules, and 6 curated lists for Research-Claw and AI agents",
   "keywords": [

package/src/tools/arxiv.ts

@@ -1,6 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
-import { toolResult, trackedFetch, isTrackedError } from "./util.js";
+import { toolResult, trackedFetch, isTrackedError, validEnum } from "./util.js";
 
 const BASE = "https://export.arxiv.org/api/query";
 
@@ -109,11 +109,18 @@ export function createArxivTools(
         sort_by?: string;
         sort_order?: string;
       }) => {
+        if (!input?.query || input.query.trim() === "" || input.query === "undefined") {
+          return toolResult({ error: "query parameter is required and must not be empty" });
+        }
+
+        const SORT_BY = ["relevance", "lastUpdatedDate", "submittedDate"] as const;
+        const SORT_ORDER = ["ascending", "descending"] as const;
+
         const params = new URLSearchParams({
           search_query: input.query,
           max_results: String(Math.min(input.max_results ?? 10, 50)),
-          sortBy: input.sort_by ?? "relevance",
-          sortOrder: input.sort_order ?? "descending",
+          sortBy: validEnum(input.sort_by, SORT_BY, "relevance"),
+          sortOrder: validEnum(input.sort_order, SORT_ORDER, "descending"),
         });
 
         const tracked = await trackedFetch("arxiv", `${BASE}?${params}`, undefined, 15_000);

package/src/tools/biorxiv.ts

@@ -1,6 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
-import { toolResult, trackedFetch, isTrackedError } from "./util.js";
+import { toolResult, trackedFetch, isTrackedError, validEnum } from "./util.js";
 
 const BASE = "https://api.biorxiv.org";
 
@@ -128,7 +128,7 @@ export function createBiorxivTools(
         if (!input?.doi) {
           return toolResult({ error: 'doi parameter is required (e.g., "10.1101/2024.01.15.575123")' });
         }
-        const server = input.server ?? "biorxiv";
+        const server = validEnum(input.server, ["biorxiv", "medrxiv"] as const, "biorxiv");
         const doi = input.doi.replace(/^https?:\/\/doi\.org\//, "");
         const tracked = await trackedFetch(server, `${BASE}/details/${server}/${doi}/na/json`, undefined, 15_000);
         if (isTrackedError(tracked)) return tracked;

package/src/tools/crossref.ts

@@ -1,6 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
-import { toolResult, trackedFetch, isTrackedError } from "./util.js";
+import { toolResult, trackedFetch, isTrackedError, validParam } from "./util.js";
 
 const BASE = "https://api.crossref.org";
 
@@ -114,16 +114,20 @@ export function createCrossRefTools(
         const filters: string[] = [];
         if (input.from_year) filters.push(`from-pub-date:${input.from_year}`);
         if (input.until_year) filters.push(`until-pub-date:${input.until_year}`);
-        if (input.type) filters.push(`type:${input.type}`);
+        const type = validParam(input.type);
+        if (type) filters.push(`type:${type}`);
         if (input.has_abstract) filters.push("has-abstract:true");
-        if (input.issn) filters.push(`issn:${input.issn}`);
+        const issn = validParam(input.issn);
+        if (issn) filters.push(`issn:${issn}`);
         if (filters.length > 0) params.set("filter", filters.join(","));
 
         // Journal name as query.container-title (separate from filter)
-        if (input.journal) params.set("query.container-title", input.journal);
+        const journal = validParam(input.journal);
+        if (journal) params.set("query.container-title", journal);
 
-        if (input.sort) {
-          params.set("sort", input.sort);
+        const sort = validParam(input.sort);
+        if (sort) {
+          params.set("sort", sort);
           params.set("order", "desc");
         }
 

package/src/tools/datacite.ts

@@ -1,6 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
-import { toolResult, trackedFetch, isTrackedError } from "./util.js";
+import { toolResult, trackedFetch, isTrackedError, validParam } from "./util.js";
 
 const BASE = "https://api.datacite.org";
 
@@ -42,8 +42,9 @@ export function createDataCiteTools(
           query: input.query,
           "page[size]": String(pageSize),
         });
-        if (input.resource_type) {
-          params.set("resource-type-id", input.resource_type.toLowerCase());
+        const resourceType = validParam(input.resource_type);
+        if (resourceType) {
+          params.set("resource-type-id", resourceType.toLowerCase());
         }
         if (input.from_year) {
           params.set("query", `${input.query} AND publicationYear:[${input.from_year} TO *]`);

package/src/tools/doaj.ts

@@ -1,6 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
-import { toolResult, trackedFetch, isTrackedError } from "./util.js";
+import { toolResult, trackedFetch, isTrackedError, validParam } from "./util.js";
 
 const BASE = "https://doaj.org/api";
 
@@ -39,7 +39,8 @@ export function createDoajTools(
         const page = input.page ?? 1;
 
         let url = `${BASE}/search/articles/${encodeURIComponent(input.query)}?page=${page}&pageSize=${pageSize}`;
-        if (input.sort) url += `&sort=${encodeURIComponent(input.sort)}`;
+        const sort = validParam(input.sort);
+        if (sort) url += `&sort=${encodeURIComponent(sort)}`;
 
         const tracked = await trackedFetch("doaj", url);
         if (isTrackedError(tracked)) return tracked;

package/src/tools/europe-pmc.ts

@@ -1,6 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
-import { toolResult, trackedFetch, isTrackedError } from "./util.js";
+import { toolResult, trackedFetch, isTrackedError, validParam, validEnum } from "./util.js";
 
 const BASE = "https://www.ebi.ac.uk/europepmc/webservices/rest";
 
@@ -43,8 +43,9 @@ export function createEuropePmcTools(
           pageSize: String(Math.min(input.max_results ?? 10, 1000)),
           resultType: "core",
         });
-        if (input.sort) params.set("sort", input.sort);
-        params.set("cursorMark", input.cursor ?? "*");
+        const sort = validParam(input.sort);
+        if (sort) params.set("sort", sort);
+        params.set("cursorMark", validParam(input.cursor) ?? "*");
 
         const tracked = await trackedFetch("europe_pmc", `${BASE}/search?${params}`);
         if (isTrackedError(tracked)) return tracked;

package/src/tools/hal.ts

@@ -1,6 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
-import { toolResult, trackedFetch, isTrackedError } from "./util.js";
+import { toolResult, trackedFetch, isTrackedError, validParam, validEnum } from "./util.js";
 
 const BASE = "https://api.archives-ouvertes.fr";
 
@@ -56,8 +56,9 @@ export function createHalTools(
         doc_type?: string;
       }) => {
         let q = input.query;
-        if (input.doc_type) {
-          q = `(${q}) AND docType_s:${input.doc_type}`;
+        const docType = validParam(input.doc_type);
+        if (docType) {
+          q = `(${q}) AND docType_s:${docType}`;
         }
 
         const params = new URLSearchParams({
@@ -66,7 +67,8 @@ export function createHalTools(
           rows: String(Math.min(input.rows ?? 10, 100)),
           wt: "json",
         });
-        if (input.sort) params.set("sort", input.sort);
+        const sort = validParam(input.sort);
+        if (sort) params.set("sort", sort);
 
         const result = await trackedFetch(
           "hal",

package/src/tools/inspire-hep.ts

@@ -1,6 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
-import { toolResult, trackedFetch, isTrackedError } from "./util.js";
+import { toolResult, trackedFetch, isTrackedError, validEnum } from "./util.js";
 
 const BASE = "https://inspirehep.net/api";
 
@@ -99,10 +99,11 @@ export function createInspireHepTools(
         ),
       }),
       execute: async (input: { query: string; size?: number; sort?: string }) => {
+        const sort = validEnum(input.sort, ["mostrecent", "mostcited", "bestmatch"] as const, "bestmatch");
         const params = new URLSearchParams({
           q: input.query,
           size: String(Math.min(input.size ?? 10, 100)),
-          sort: input.sort ?? "bestmatch",
+          sort,
         });
 
         const result = await trackedFetch(

package/src/tools/openaire.ts

@@ -1,6 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
-import { toolResult, trackedFetch, isTrackedError } from "./util.js";
+import { toolResult, trackedFetch, isTrackedError, validParam } from "./util.js";
 
 const BASE = "https://api.openaire.eu";
 
@@ -127,12 +127,17 @@ export function createOpenAireTools(
           format: "json",
           size: String(Math.min(input.max_results ?? 10, 50)),
         });
-        if (input.author) params.set("author", input.author);
-        if (input.doi) params.set("doi", input.doi);
-        if (input.from_date) params.set("fromDateAccepted", input.from_date);
-        if (input.to_date) params.set("toDateAccepted", input.to_date);
+        const author = validParam(input.author);
+        if (author) params.set("author", author);
+        const doi = validParam(input.doi);
+        if (doi) params.set("doi", doi);
+        const fromDate = validParam(input.from_date);
+        if (fromDate) params.set("fromDateAccepted", fromDate);
+        const toDate = validParam(input.to_date);
+        if (toDate) params.set("toDateAccepted", toDate);
         if (input.oa_only) params.set("OA", "true");
-        if (input.funder) params.set("funder", input.funder);
+        const funder = validParam(input.funder);
+        if (funder) params.set("funder", funder);
 
         const tracked = await trackedFetch("openaire", `${BASE}/search/publications?${params}`, undefined, 15_000);
         if (isTrackedError(tracked)) return tracked;

package/src/tools/openalex.ts

@@ -1,6 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
-import { toolResult, trackedFetch, isTrackedError } from "./util.js";
+import { toolResult, trackedFetch, isTrackedError, validParam, validEnum } from "./util.js";
 
 const BASE = "https://api.openalex.org";
 
@@ -46,6 +46,12 @@ export function createOpenAlexTools(
         open_access?: boolean;
         sort_by?: string;
       }) => {
+        if (!input?.query || input.query.trim() === "" || input.query === "undefined") {
+          return toolResult({ error: "query parameter is required and must not be empty" });
+        }
+
+        const SORT_BY = ["cited_by_count", "publication_date", "relevance_score"] as const;
+
         const filters: string[] = [];
         if (input.from_year) filters.push(`from_publication_date:${input.from_year}-01-01`);
         if (input.to_year) filters.push(`to_publication_date:${input.to_year}-12-31`);
@@ -56,7 +62,10 @@ export function createOpenAlexTools(
           per_page: String(Math.min(input.limit ?? 10, 200)),
         });
         if (filters.length > 0) params.set("filter", filters.join(","));
-        if (input.sort_by) params.set("sort", input.sort_by);
+        const sortBy = validParam(input.sort_by);
+        if (sortBy && (SORT_BY as readonly string[]).includes(sortBy)) {
+          params.set("sort", sortBy);
+        }
 
         const tracked = await trackedFetch("openalex", `${BASE}/works?${params}`, { headers });
         if (isTrackedError(tracked)) return tracked;

package/src/tools/osf-preprints.ts

@@ -1,6 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
-import { toolResult, trackedFetch, isTrackedError } from "./util.js";
+import { toolResult, trackedFetch, isTrackedError, validParam } from "./util.js";
 
 const BASE = "https://api.osf.io/v2";
 
@@ -36,7 +36,8 @@ export function createOsfPreprintsTools(
         const params = new URLSearchParams({
           "page[size]": String(Math.min(input.size ?? 10, 100)),
         });
-        if (input.provider) params.set("filter[provider]", input.provider);
+        const provider = validParam(input.provider);
+        if (provider) params.set("filter[provider]", provider);
         if (input.page) params.set("page", String(input.page));
 
         const result = await trackedFetch(

package/src/tools/pubmed.ts

@@ -1,6 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
-import { toolResult, trackedFetch, isTrackedError } from "./util.js";
+import { toolResult, trackedFetch, isTrackedError, validParam, validEnum } from "./util.js";
 
 const EUTILS = "https://eutils.ncbi.nlm.nih.gov/entrez/eutils";
 
@@ -41,17 +41,21 @@ export function createPubMedTools(
         min_date?: string;
         max_date?: string;
       }) => {
+        const sort = validEnum(input.sort, ["relevance", "pub_date"] as const, "relevance");
+        const minDate = validParam(input.min_date);
+        const maxDate = validParam(input.max_date);
+
         const searchParams = new URLSearchParams({
           db: "pubmed",
           term: input.query,
           retmax: String(Math.min(input.max_results ?? 10, 100)),
           retmode: "json",
-          sort: input.sort ?? "relevance",
+          sort,
           usehistory: "y",
         });
-        if (input.min_date) searchParams.set("mindate", input.min_date);
-        if (input.max_date) searchParams.set("maxdate", input.max_date);
-        if (input.min_date || input.max_date) searchParams.set("datetype", "pdat");
+        if (minDate) searchParams.set("mindate", minDate);
+        if (maxDate) searchParams.set("maxdate", maxDate);
+        if (minDate || maxDate) searchParams.set("datetype", "pdat");
 
         const searchTracked = await trackedFetch("pubmed", `${EUTILS}/esearch.fcgi?${searchParams}`);
         if (isTrackedError(searchTracked)) return searchTracked;

package/src/tools/util.ts

@@ -150,3 +150,36 @@ export function isTrackedError(
 ): result is ReturnType<typeof toolResult> {
   return "content" in result && "details" in result;
 }
+
+// ── LLM Input Sanitization ──────────────────────────────────────────────
+
+const INVALID_PARAM_VALUES = new Set(["undefined", "null", "none", "None", ""]);
+
+/**
+ * Sanitize an optional string parameter from LLM tool calls.
+ *
+ * LLMs (especially weaker models) sometimes pass the literal string "undefined"
+ * or "null" instead of omitting the parameter. The nullish coalescing operator
+ * (`??`) does NOT catch these because they are truthy strings.
+ *
+ * Returns the value if valid, or `undefined` if it's a known non-value.
+ */
+export function validParam(value: string | undefined | null): string | undefined {
+  if (value == null) return undefined;
+  if (INVALID_PARAM_VALUES.has(value.trim())) return undefined;
+  return value;
+}
+
+/**
+ * Validate a string parameter against a whitelist of allowed values.
+ * Returns the value if it matches, or the fallback otherwise.
+ */
+export function validEnum<T extends string>(
+  value: string | undefined | null,
+  allowed: readonly T[],
+  fallback: T,
+): T {
+  const clean = validParam(value);
+  if (clean && (allowed as readonly string[]).includes(clean)) return clean as T;
+  return fallback;
+}

package/src/tools/zenodo.ts

@@ -1,6 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
-import { toolResult, trackedFetch, isTrackedError } from "./util.js";
+import { toolResult, trackedFetch, isTrackedError, validParam } from "./util.js";
 
 const BASE = "https://zenodo.org/api";
 
@@ -48,9 +48,12 @@ export function createZenodoTools(
           q: input.query,
           size: String(Math.min(input.size ?? 10, 100)),
         });
-        if (input.type) params.set("type", input.type);
-        if (input.sort) params.set("sort", input.sort);
-        if (input.access_right) params.set("access_right", input.access_right);
+        const type = validParam(input.type);
+        if (type) params.set("type", type);
+        const sort = validParam(input.sort);
+        if (sort) params.set("sort", sort);
+        const accessRight = validParam(input.access_right);
+        if (accessRight) params.set("access_right", accessRight);
 
         const result = await trackedFetch("zenodo", `${BASE}/records?${params}`, undefined, 10_000);
         if (isTrackedError(result)) return result;