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

scripts/preflight.py

View on GitHub
# -*- coding: utf-8 -*-
"""
Pre-flight API endpoint connectivity checker.

Verifies that the 3 direct API endpoints used by format-converter.py are
reachable. Uses urllib.request.urlopen (stdlib) for consistency with the
existing codebase.

Usage:
  python preflight.py                       # run check and print report
  python -c "from preflight import check_endpoints; print(check_endpoints())"
"""

import sys
import time
from urllib.request import urlopen

ENDPOINTS = [
    {
        "name": "PubMed E-utilities",
        "url": "https://eutils.ncbi.nlm.nih.gov/entrez/eutils/esearch.fcgi?db=pubmed&retmax=1",
        "timeout": 10,
        "affected": "PubMed downloads in format-converter",
    },
    {
        "name": "CrossRef REST",
        "url": "https://api.crossref.org/works/10.1038/nature14539",
        "timeout": 10,
        "affected": "CrossRef/DOI downloads in format-converter",
        "expect_status": 200,
    },
    {
        "name": "arXiv API",
        "url": "https://export.arxiv.org/api/query?id_list=1706.03762&max_results=1",
        "timeout": 10,
        "affected": "arXiv downloads in format-converter (MCP search_arxiv unaffected)",
    },
]


def check_single(name, url, timeout, expect_status=None):
    """Check a single endpoint. Returns (ok, elapsed, error_message_or_None)."""
    start = time.perf_counter()
    try:
        with urlopen(url, timeout=timeout) as resp:
            status = resp.status
            _ = resp.read()  # consume body to confirm full response
        elapsed = time.perf_counter() - start
        if expect_status is not None and status != expect_status:
            return False, elapsed, f"unexpected HTTP {status} (expected {expect_status})"
        return True, elapsed, None
    except Exception as e:
        elapsed = time.perf_counter() - start
        # Produce a short error label: prefer the os-error string over full traceback
        error_str = str(e)
        if "time" in error_str.lower() and "out" in error_str.lower():
            error_str = "timeout after {}s".format(timeout)
        elif hasattr(e, "reason") and e.reason is not None:
            error_str = str(e.reason)
        elif hasattr(e, "code"):
            error_str = "HTTP {}".format(e.code)
        return False, elapsed, error_str


def check_endpoints():
    """Check all configured endpoints.

    Returns:
        dict[str, dict]: {name: {"ok": bool, "time": float, "error": str|None}}
    """
    results = {}
    for ep in ENDPOINTS:
        ok, elapsed, error = check_single(
            ep["name"],
            ep["url"],
            ep["timeout"],
            ep.get("expect_status"),
        )
        results[ep["name"]] = {
            "ok": ok,
            "time": elapsed,
            "error": error,
        }
    return results


def print_report(results):
    """Print a human-readable pre-flight report."""
    ok_count = sum(1 for v in results.values() if v["ok"])
    total = len(results)

    print("PRE-FLIGHT REPORT")
    for name, info in results.items():
        status = "OK" if info["ok"] else "FAIL"
        if info["ok"]:
            extra = ""
        else:
            extra = " ({})".format(info["error"])
        print("  {:20s}: {} ({:.1f}s){}".format(name, status, info["time"], extra))

    print("  {}/{} endpoints reachable.".format(ok_count, total))

    if ok_count < total:
        print("  Affected:")
        for ep in ENDPOINTS:
            name = ep["name"]
            info = results[name]
            if not info["ok"]:
                print("    - {}: {}".format(name, ep["affected"]))

    return ok_count == total


def main():
    results = check_endpoints()
    all_ok = print_report(results)
    sys.exit(0 if all_ok else 1)


if __name__ == "__main__":
    main()
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