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.md
source 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

  • api_search
    - Calls
    https://api.openalex.org/works
    with the
    search
    query parameter and
    per-page=10
    , then maps
    results
    entries into normalized evidence.
  • api_search
    - Reconstructs abstract text from OpenAlex's positional
    abstract_inverted_index
    representation before building snippet and content fields.
  • api_search
    - Resolves evidence URLs in priority order:
    best_oa_location.landing_page_url
    , then
    doi
    , then the OpenAlex
    id
    fallback.

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
    search
    query parameter for keyword search, not
    filter
    , which is for metadata filtering syntax.
  • 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.