Skip to content

Yuan1z0825/nature-skills / skills/nature-academic-search

nature-academic-search

Flagged

Search literature across sources, verify or manage citations, and build MeSH strategies or citation-impact audits. Use for 文献检索、引文核对、参考文献管理、严格他引 and evidence-backed citer profiles; not for translating a paper or drafting manuscript prose.

FileKindSize
README.mdmarkdown2.6 KB
README_EN.mdmarkdown3.0 KB
SKILL.mdexecutableskill md3.5 KB
agents/openai.yamlconfig265 B
config/mcp-snippet.jsonconfig502 B
config/settings-snippet.jsonconfig59 B
config/triggers-academic-search.tomlconfig978 B
install.shexecutablescript4.3 KB
manifest.yamlconfig3.1 KB
mcp-server/README.mdmarkdown1.9 KB
mcp-server/academic_search_server.pyscript20.9 KB
mcp-server/config.tomlconfig249 B
mcp-server/requirements.txtmanifest134 B
mcp-server/sources/__init__.pyscript352 B
mcp-server/sources/arxiv.pyscript11.4 KB
mcp-server/sources/crossref.pyscript8.0 KB
mcp-server/sources/elsevier_common.pyscript2.4 KB
mcp-server/sources/pubmed.pyscript13.7 KB
mcp-server/sources/sciencedirect.pyscript6.9 KB
mcp-server/sources/scopus.pyscript19.0 KB
mcp-server/tests/__init__.pyscript40 B
mcp-server/tests/test_arxiv_error_entries.pyscript1.4 KB
mcp-server/tests/test_citation_errors.pyscript1.6 KB
mcp-server/tests/test_crossref_version_relations.pyscript3.3 KB
mcp-server/tests/test_elsevier_live.pyscript2.6 KB
mcp-server/tests/test_format_converter_hardening.pyscript4.2 KB
mcp-server/tests/test_mcp_tools.pyscript2.6 KB
mcp-server/tests/test_pubmed_parsing.pyscript4.4 KB
mcp-server/tests/test_scopus_empty_result.pyscript1006 B
mcp-server/tests/test_script_converters.pyscript2.9 KB
mcp-server/tests/test_sources.pyscript30.5 KB
mcp-server/utils/__init__.pyscript359 B
mcp-server/utils/config.pyscript1.4 KB
mcp-server/utils/errors.pyscript620 B
mcp-server/utils/logging.pyscript1.1 KB
references/citation-parser.mdmarkdown2.7 KB
references/dedup-engine.mdmarkdown1.9 KB
references/pubmed-28344011.bibexecutablescript3.3 KB
references/pubmed-28344011.nbibexecutablescript11.9 KB
references/pubmed-28344011.risexecutablescript3.4 KB
references/ris-bibtex-format.mdexecutablescript4.5 KB
references/search-strategy.mdexecutablescript2.0 KB
references/source-tiers.mdmarkdown2.7 KB
references/workflows/wf1-multi-source-search.mdmarkdown1.9 KB
references/workflows/wf2-citation-verification.mdmarkdown1.6 KB
references/workflows/wf3-mesh-strategy.mdmarkdown538 B
references/workflows/wf4-citation-file-mgmt.mdmarkdown1.9 KB
references/workflows/wf5-reference-mgmt.mdmarkdown1.5 KB
references/workflows/wf6-strict-other-citation-impact-audit.mdmarkdown11.2 KB
scripts/academic_search.pyscript23.2 KB
scripts/converters.pyscript18.5 KB
scripts/format-converter.pyscript19.5 KB
scripts/preflight.pyscript3.7 KB
static/core/routing-and-ops.mdmarkdown6.1 KB
static/core/tools.mdmarkdown3.0 KB

references/source-tiers.md

View on GitHub
# Source Tiers & Reliability

Every academic data source is classified by reliability tier to guide automated fallback routing.

## Tier Definitions

| Tier | Label | API Quality | Fallback Behavior |
|------|-------|-------------|-------------------|
| **T1** | API-backed, structured | Official REST/XML API, stable schema | Use first. If fails → next T1 source. |
| **T2** | API-backed, limited | Official API but narrow coverage or low rate limits | Use when T1 exhausted or insufficient. |
| **T3** | Scraped, unstable | Web scraping, no contract on response format | Last resort. Always warn user: "results may be incomplete or stale". |

## Source Classification

### T1 — API-backed, Structured

| Source | API | Rate Limit | Notes |
|--------|-----|------------|-------|
| PubMed | E-utilities (XML/JSON) | 3 req/s (10 with API key) | Biomedical + life sciences, MeSH indexing |
| CrossRef | REST API (JSON) | 50 req/s (no key needed) | Cross-disciplinary, citation counts |
| arXiv | OAI-PMH Atom XML | 1 req/3s | Preprints: physics, math, CS, biology |

### T2 — API-backed, Limited

| Source | API | Rate Limit | Notes |
|--------|-----|------------|-------|
| Semantic Scholar | REST API (JSON) | 1 req/s (100 with API key) | Citation graph, field-of-study filters |
| bioRxiv | API | Limited metadata | Biology preprints only |
| medRxiv | API | Limited metadata | Medical preprints only |

### T3 — Scraped, Unstable

| Source | Method | Risk |
|--------|--------|------|
| Google Scholar | HTML scrape | CAPTCHA blocks, IP bans |
| Web of Science | Institution proxy required | Access varies |
| Scopus | Institution proxy required | Access varies |
| CNKI / 万方 | No programmatic access | Chinese only, manual download |

## Fallback Routing Rules

For every literature search or citation verification:

```
1. SELECT T1 sources matching the query domain
2. SEARCH all selected T1 sources in parallel
3. If (result found AND relevance > threshold) → ACCEPT
4. If T1 exhausted or insufficient → ESCALATE to T2
5. If T1+T2 exhausted → ESCALATE to T3 + WARN USER
6. If all exhausted → return partial results + suggest query refinement
```

### Domain → Tier Mapping

| Domain | T1 | T2 | T3 (if needed) |
|--------|-----|-----|-----------------|
| Medical / clinical | PubMed | Semantic Scholar | Google Scholar |
| Cross-disciplinary | CrossRef | Semantic Scholar | Scopus |
| Preprints / CS / physics | arXiv | bioRxiv / medRxiv | Google Scholar |
| Exhaustive review | PubMed + CrossRef + arXiv | Semantic Scholar + bioRxiv/medRxiv | WoS / Scopus |
| Citation verification | CrossRef (DOI) → PubMed (PMID) | Semantic Scholar | Google Scholar |
| Chinese literature | — | — | CNKI / 万方 (manual) |
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 196kUpdated Claude CodeCodexVerifiedInstall