openalex
Search academic papers via OpenAlex API for open citation data, institutional affiliations, and funding information. Use when user says "openalex search", "search openalex", "open citation graph", or wants comprehensive academic metadata beyond arXiv/Semantic Scholar.
wanshuiyin · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add wanshuiyin/Auto-claude-code-research-in-sleep --skill openalex技能说明
name: openalex description: Search academic papers via OpenAlex API for open citation data, institutional affiliations, and funding information. Use when user says "openalex search", "search openalex", "open citation graph", or wants comprehensive academic metadata beyond arXiv/Semantic Scholar. argument-hint: "[search-query]" allowed-tools: Bash(*), Read, Write
OpenAlex Academic Search
Search query: $ARGUMENTS
Role & Positioning
This skill uses OpenAlex as a comprehensive open academic graph source:
| Skill | Source | Best for |
|---|---|---|
/arxiv | arXiv API | Latest preprints, cutting-edge unrefereed work |
/semantic-scholar | Semantic Scholar API | Published venue papers (IEEE, ACM, Springer) with citation counts |
/openalex | OpenAlex API | Open citation graph, institutional affiliations, funding data, comprehensive metadata |
/deepxiv | DeepXiv CLI | Layered reading: search, brief, section map, section reads |
/exa-search | Exa API | Broad web search: blogs, docs, news, companies, research papers |
/gemini-search | Gemini MCP / CLI | AI-powered broad literature discovery |
Use OpenAlex when you want:
- Open citation data — fully open citation graph (no API key required for basic use)
- Institutional affiliations — author institutions and collaborations
- Funding information — NSF, NIH, and other funding sources
- Comprehensive metadata — topics, keywords, abstract, open access status
- Cross-database coverage — indexes 250M+ works from multiple sources
Constants
- MAX_RESULTS = 10 — Default number of results. Override with
— max: 20. - DEFAULT_SORT = relevance — Sort by relevance. Override with
— sort: citationsor— sort: date. - OPENALEX_FETCHER — canonical name
openalex_fetch.py, resolved pershared-references/integration-contract.md§2 (Policy D1 — standalone/openalexhas no documented inline fallback, so unresolved helper terminates with an explicit error).
Overrides (append to arguments):
/openalex "topic" — max: 20— return up to 20 results/openalex "topic" — year: 2023-— papers from 2023 onward/openalex "topic" — year: 2020-2023— papers from 2020 to 2023/openalex "topic" — type: article— only journal articles/openalex "topic" — type: preprint— only preprints/openalex "topic" — open-access— only open access papers/openalex "topic" — min-citations: 50— minimum 50 citations/openalex "topic" — sort: citations— sort by citation count (descending)/openalex "topic" — sort: date— sort by publication date (newest first)
Setup
Prerequisites
-
Python 3.7+ with
requestslibrary:pip install requests -
Optional: API keys — Create
.claude/.envin project root:# Copy from template cp .claude/.env.example .claude/.env # Edit and add your keys # .claude/.env OPENALEX_API_KEY=your-key-here OPENALEX_EMAIL=your-email@example.comClaude Code automatically loads
.claude/.envas environment variables. -
Get API keys (optional but recommended):
- OpenAlex API key: Free tier $1/day (10,000 list calls, 1,000 search calls) from openalex.org
- Email for polite pool: Faster response times (no registration needed)
Verify Setup
python3 "$OPENALEX_FETCHER" search "machine learning" --max 3
(Resolve $OPENALEX_FETCHER via the canonical chain first — see Step 2 below.)
Workflow
Step 1: Parse Arguments
Parse $ARGUMENTS for:
- query: The research topic (required)
- max: Override MAX_RESULTS
- year: Publication year filter (e.g.,
2023-,2020-2023) - type: Work type filter (
article,preprint,book,book-chapter,dataset,dissertation) - open-access: Only include open access papers
- min-citations: Minimum citation count threshold
- sort: Sort order (
relevance,citations,date)
Step 2: Locate Script
Resolve $OPENALEX_FETCHER via the canonical strict-safe chain (see
shared-references/integration-contract.md §2).
Policy D1: there is no native inline fallback for OpenAlex
(retrieval requires the requests SDK + optional API key — the
fetcher script encapsulates pagination, throttling, and per-source
parameters), so unresolved helper terminates with explicit remediation.
cd "$(git rev-parse --show-toplevel 2>/dev/null || pwd)" || exit 1
if [ -z "${ARIS_REPO:-}" ] && [ -f .aris/installed-skills.txt ]; then
ARIS_REPO=$(awk -F'\t' '$1=="repo_root"{print $2; exit}' .aris/installed-skills.txt 2>/dev/null) || true
fi
if [ -z "${ARIS_REPO:-}" ] && [ -f "$HOME/.aris/repo" ]; then
ARIS_REPO=$(cat "$HOME/.aris/repo" 2>/dev/null) || true
fi
OPENALEX_FETCHER=".aris/tools/openalex_fetch.py"
[ -f "$OPENALEX_FETCHER" ] || OPENALEX_FETCHER="tools/openalex_fetch.py"
[ -f "$OPENALEX_FETCHER" ] || { [ -n "${ARIS_REPO:-}" ] && OPENALEX_FETCHER="$ARIS_REPO/tools/openalex_fetch.py"; }
[ -f "$OPENALEX_FETCHER" ] || {
echo "ERROR: openalex_fetch.py not resolved at .aris/tools/, tools/, \$ARIS_REPO/tools/, or via ~/.aris/repo." >&2
echo " Fix: rerun bash tools/install_aris.sh or smart_update.sh (refreshes ~/.aris/repo), export ARIS_REPO, or copy the helper to tools/." >&2
echo " Also ensure 'requests' is installed: pip install requests" >&2
exit 1
}
Step 3: Execute Search
Basic search:
python3 "$OPENALEX_FETCHER" search "QUERY" --max 10
With filters:
python3 "$OPENALEX_FETCHER" search "QUERY" --max 10 \
--year 2023- \
--type article \
--open-access \
--min-citations 20 \
--sort citations
Get specific work by DOI:
python3 "$OPENALEX_FETCHER" work "10.1109/TWC.2024.1234567"
Get specific work by OpenAlex ID:
阅读完整来源 ↗