Yuan1z0825/nature-skills / skills/nature-academic-search
nature-academic-search
FlaggedSearch 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.
mcp-server/sources/elsevier_common.py
View on GitHub"""Shared helpers for pybliometrics-backed Elsevier sources."""
from __future__ import annotations
from pathlib import Path
from threading import Lock
from typing import Any
from pybliometrics import init as pybliometrics_init
from pybliometrics.utils.constants import CONFIG_FILE
from utils.errors import DataSourceError
_init_lock = Lock()
_initialised = False
def ensure_pybliometrics_config(source: str) -> None:
"""Initialise pybliometrics from its configured file.
pybliometrics creates a config interactively when the file is absent. MCP
servers cannot prompt, so missing or invalid config is reported explicitly.
"""
config_path = Path(CONFIG_FILE)
if not config_path.exists():
raise DataSourceError(
source,
f"pybliometrics config not found at {config_path}",
)
global _initialised
with _init_lock:
if _initialised:
return
try:
pybliometrics_init(config_path=config_path)
except (FileNotFoundError, ValueError) as exc:
raise DataSourceError(
source,
f"pybliometrics config is invalid at {config_path}: {exc}",
original_error=exc,
) from exc
_initialised = True
def record_to_dict(value: Any) -> Any:
"""Recursively convert pybliometrics records into JSON-safe structures."""
if value is None or isinstance(value, (str, int, float, bool)):
return value
if hasattr(value, "_asdict"):
return {k: record_to_dict(v) for k, v in value._asdict().items()}
if isinstance(value, dict):
return {str(k): record_to_dict(v) for k, v in value.items()}
if isinstance(value, (list, tuple, set)):
return [record_to_dict(v) for v in value]
return value
def safe_attr(obj: Any, name: str) -> Any:
"""Read an optional pybliometrics property."""
try:
return getattr(obj, name)
except (AttributeError, KeyError, TypeError):
return None
def split_semicolon(value: str | None) -> list[str]:
"""Split pybliometrics semicolon-joined fields."""
if not value:
return []
return [item.strip() for item in value.split(";") if item.strip()]
def year_from_date(value: str | None) -> int | None:
"""Extract a publication year from an ISO-like date string."""
if not value or len(value) < 4:
return None
try:
return int(value[:4])
except ValueError:
return None
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |