Autosearch openalex
Search scholarly works through OpenAlex's public works search API with open-access URL fallback.
install
source · Clone the upstream repo
git clone https://github.com/0xmariowu/Autosearch
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/0xmariowu/Autosearch "$T" && mkdir -p ~/.claude/skills && cp -r "$T/autosearch/skills/channels/openalex" ~/.claude/skills/0xmariowu-autosearch-openalex && rm -rf "$T"
manifest:
autosearch/skills/channels/openalex/SKILL.mdsource content
Overview
OpenAlex provides broad scholarly metadata coverage across papers, preprints, chapters, and other research outputs through a free public API. It is useful when the query needs paper titles, authors, abstracts, citation counts, and open-access landing pages across a much larger corpus than a single publisher or preprint server.
When to Choose It
- Choose it for paper discovery, survey-building, citation-oriented lookup, and research-heavy English or mixed-language queries.
- Choose it when open-access landing pages or DOI links are valuable because the planner may need a direct path from metadata to readable paper pages.
- Choose it when the search should cover both preprints and published literature rather than only one repository.
How To Search
- Callsapi_search
with thehttps://api.openalex.org/works
query parameter andsearch
, then mapsper-page=10
entries into normalized evidence.results
- Reconstructs abstract text from OpenAlex's positionalapi_search
representation before building snippet and content fields.abstract_inverted_index
- Resolves evidence URLs in priority order:api_search
, thenbest_oa_location.landing_page_url
, then the OpenAlexdoi
fallback.id
Known Quirks
- Abstracts are returned as an inverted index rather than plain prose, so the channel reconstructs them into normal text before truncation.
- Use OpenAlex's
query parameter for keyword search, notsearch
, which is for metadata filtering syntax.filter - OpenAlex is rate-limited to roughly 10 requests per second without auth, and the single-call-per-subquery pattern here stays well under that ceiling.
Quality Bar
- Evidence items have non-empty title and url.
- No crash on empty or malformed API response.
- Source channel field matches the channel name.