Science Search (ScienceMadeReadable)
Search ~200 million peer-reviewed papers and academic preprints across all fields of science.
- Base URL:
https://api.sciencemadereadable.com/api/data
- Authentication: Free, read-only JSON over HTTPS, no API key required.
- Reference Doc:
GET https://api.sciencemadereadable.com/api/data/llms.txt
1. Quick Invocation (Cross-Platform)
Option A: Direct Web Fetch / Agent Fallback (No CLI Required)
If you only have a web fetching tool (read_url_content / HTTP GET), request the plain-text Markdown endpoint directly:
https://ask.sciencemadereadable.com/<question>
- Spaces can be
%20 or + (e.g. https://ask.sciencemadereadable.com/why%20do%20cats%20purr?k=10&abstracts=false)
- Accepts standard query parameters:
k (1–100), year_from, year_to, type, open_access=true, abstracts=false.
Option B: Bundled Python Helper Script (Zero Dependencies)
Run the bundled script using standard Python (python3, python, or uv run):
# Semantic search with token-saving (no abstracts)
python scripts/search_science.py "effect of intermittent fasting on weight loss" --limit 10 --no-abstracts
# Keyword / Boolean search
python scripts/search_science.py '"gut microbiome" AND autism NOT mice' --limit 5
# Look up paper by DOI or OpenAlex ID
python scripts/search_science.py --work "10.1126/science.aan8048"
# Find similar papers
python scripts/search_science.py --similar "W2782456798" --limit 5
# Citation walk (what similar papers cite that this paper does not)
python scripts/search_science.py --walk "10.1126/science.aan8048"
Option C: cURL / Shell
Bash (Linux / macOS):
B="https://api.sciencemadereadable.com/api/data"
# Semantic search
curl -sG "$B/search" --data-urlencode "q=effect of intermittent fasting on weight loss in adults" -d k=10 -d abstracts=false
# Keyword & boolean search
curl -sG "$B/search" --data-urlencode 'q="gut microbiome" AND (autism OR ASD) NOT mice' -d k=10 -d abstracts=false
# Paper lookup by DOI
curl -s "$B/works/10.1126/science.aan8048"
# Similar papers
curl -s "$B/similar/W2782456798?k=10&abstracts=false"
# Citation walk
curl -s "$B/walk?id=10.1126/science.aan8048"
PowerShell (Windows):
$B = "https://api.sciencemadereadable.com/api/data"
# Semantic search
Invoke-RestMethod -Uri "$B/search?q=effect+of+intermittent+fasting+on+weight+loss+in+adults&k=10&abstracts=false"
# Paper lookup
Invoke-RestMethod -Uri "$B/works/10.1126/science.aan8048"
2. API Endpoints Reference
| Endpoint |
Method |
Purpose |
Key Parameters |
/search |
GET |
Search papers by meaning or exact keywords |
q, mode (auto|semantic|keyword), k (1–100), year_from, year_to, type, open_access, abstracts (true|false) |
/search/{question} |
GET |
Plain-text Markdown output of search results |
Same query options as /search |
/works/{ref} |
GET |
Full paper record by DOI, W-number, or PMCID |
ref = DOI (10.xxx), OpenAlex ID (Wxxx), or PMCID (PMCxxx) |
/similar/{ref} |
GET |
Find papers closest in meaning to a specific paper |
ref, k, year_from, year_to, abstracts |
/walk?id={ref} |
GET |
Citation walk: find literature that similar papers cite |
id (DOI or W-number), k |
Key Result Fields
id: OpenAlex W-number (e.g. W2782456798)
doi: Digital Object Identifier
title: Paper title
year / date: Publication date
authors: Authors list (joined by " | ")
venue / publisher: Journal or conference name
citations: Citation count at snapshot date
abstract: Paper abstract (if abstracts=true)
score: Cosine similarity (semantic) or BM25 score (keyword)
junk: Likelihood (0.0–1.0) that the item is spam or non-scholarly
openalex: OpenAlex URL for citation
3. Best Practices for AI Agents
- Academic Phrasing Optimization:
- Transform informal questions into academic/scientific phrasing before searching.
- Example: Instead of
"how to cure insomnia", search for "non-pharmacological interventions for chronic insomnia in adults". This drastically increases semantic matching precision.
- Token Efficiency (Screening Pattern):
- Step 1: Search with
abstracts=false and k=10~20 to inspect titles, publication years, citation counts, and venues.
- Step 2: Select the top 1~3 most relevant papers and call
/works/{id} or re-query with abstracts=true only for those specific papers.
- Snowballing Literature Reviews:
- Identify 1 seminal paper $\rightarrow$ call
/similar/{id} to discover peer research $\rightarrow$ call /walk?id={doi} to capture foundational works cited across the field.
- Rate Limits & Etiquette:
- Limit: 30 requests per minute per IP address.
- Batch parameters into a single request (e.g.
k=30 once rather than multiple k=5 calls).
- Respect HTTP 429: read the
Retry-After header or retry_after JSON response field and sleep before retrying.
- Citing Papers:
- Always cite using the official DOI (
https://doi.org/<doi>) or OpenAlex URL.
- To guide human users to an interactive reading view:
https://sciencemadereadable.com/?work=<doi>.
1---2name: science-search-23description: "Search ~200 million scientific papers (OpenAlex titles and abstracts) by meaning or exact words, look up papers by DOI / OpenAlex ID / PMCID, find similar papers, and walk citation graphs through the free ScienceMadeReadable search API (no key). Use when a task requires scientific literature, finding evidence for claims, conducting literature reviews, citing peer-reviewed studies, or resolving DOIs. Triggers on: 'science search', '논문 검색', '과학 논문', '학술 자료', 'research paper', 'scientific study', 'find paper', 'DOI 검색', '의학 논문', '선행 연구'."4metadata:5 source: https://skillmd.com/skills/fritzprix/science-search-26---78# Science Search (ScienceMadeReadable)910Search ~200 million peer-reviewed papers and academic preprints across all fields of science.11- **Base URL**: `https://api.sciencemadereadable.com/api/data`12- **Authentication**: Free, read-only JSON over HTTPS, no API key required.13- **Reference Doc**: `GET https://api.sciencemadereadable.com/api/data/llms.txt`1415---1617## 1. Quick Invocation (Cross-Platform)1819### Option A: Direct Web Fetch / Agent Fallback (No CLI Required)20If you only have a web fetching tool (`read_url_content` / HTTP GET), request the plain-text Markdown endpoint directly:21```text22https://ask.sciencemadereadable.com/<question>23```24* Spaces can be `%20` or `+` (e.g. `https://ask.sciencemadereadable.com/why%20do%20cats%20purr?k=10&abstracts=false`)25* Accepts standard query parameters: `k` (1–100), `year_from`, `year_to`, `type`, `open_access=true`, `abstracts=false`.2627### Option B: Bundled Python Helper Script (Zero Dependencies)28Run the bundled script using standard Python (`python3`, `python`, or `uv run`):29```bash30# Semantic search with token-saving (no abstracts)31python scripts/search_science.py "effect of intermittent fasting on weight loss" --limit 10 --no-abstracts3233# Keyword / Boolean search34python scripts/search_science.py '"gut microbiome" AND autism NOT mice' --limit 53536# Look up paper by DOI or OpenAlex ID37python scripts/search_science.py --work "10.1126/science.aan8048"3839# Find similar papers40python scripts/search_science.py --similar "W2782456798" --limit 54142# Citation walk (what similar papers cite that this paper does not)43python scripts/search_science.py --walk "10.1126/science.aan8048"44```4546### Option C: cURL / Shell47**Bash (Linux / macOS):**48```bash49B="https://api.sciencemadereadable.com/api/data"5051# Semantic search52curl -sG "$B/search" --data-urlencode "q=effect of intermittent fasting on weight loss in adults" -d k=10 -d abstracts=false5354# Keyword & boolean search55curl -sG "$B/search" --data-urlencode 'q="gut microbiome" AND (autism OR ASD) NOT mice' -d k=10 -d abstracts=false5657# Paper lookup by DOI58curl -s "$B/works/10.1126/science.aan8048"5960# Similar papers61curl -s "$B/similar/W2782456798?k=10&abstracts=false"6263# Citation walk64curl -s "$B/walk?id=10.1126/science.aan8048"65```6667**PowerShell (Windows):**68```powershell69$B = "https://api.sciencemadereadable.com/api/data"7071# Semantic search72Invoke-RestMethod -Uri "$B/search?q=effect+of+intermittent+fasting+on+weight+loss+in+adults&k=10&abstracts=false"7374# Paper lookup75Invoke-RestMethod -Uri "$B/works/10.1126/science.aan8048"76```7778---7980## 2. API Endpoints Reference8182| Endpoint | Method | Purpose | Key Parameters |83|---|---|---|---|84| `/search` | GET | Search papers by meaning or exact keywords | `q`, `mode` (`auto`\|`semantic`\|`keyword`), `k` (1–100), `year_from`, `year_to`, `type`, `open_access`, `abstracts` (`true`\|`false`) |85| `/search/{question}` | GET | Plain-text Markdown output of search results | Same query options as `/search` |86| `/works/{ref}` | GET | Full paper record by DOI, W-number, or PMCID | `ref` = DOI (`10.xxx`), OpenAlex ID (`Wxxx`), or PMCID (`PMCxxx`) |87| `/similar/{ref}` | GET | Find papers closest in meaning to a specific paper | `ref`, `k`, `year_from`, `year_to`, `abstracts` |88| `/walk?id={ref}` | GET | Citation walk: find literature that similar papers cite | `id` (DOI or W-number), `k` |8990### Key Result Fields91* `id`: OpenAlex W-number (e.g. `W2782456798`)92* `doi`: Digital Object Identifier93* `title`: Paper title94* `year` / `date`: Publication date95* `authors`: Authors list (joined by `" | "`)96* `venue` / `publisher`: Journal or conference name97* `citations`: Citation count at snapshot date98* `abstract`: Paper abstract (if `abstracts=true`)99* `score`: Cosine similarity (semantic) or BM25 score (keyword)100* `junk`: Likelihood (0.0–1.0) that the item is spam or non-scholarly101* `openalex`: OpenAlex URL for citation102103---104105## 3. Best Practices for AI Agents1061071. **Academic Phrasing Optimization**:108 * Transform informal questions into academic/scientific phrasing before searching.109 * *Example*: Instead of `"how to cure insomnia"`, search for `"non-pharmacological interventions for chronic insomnia in adults"`. This drastically increases semantic matching precision.1102. **Token Efficiency (Screening Pattern)**:111 * **Step 1**: Search with `abstracts=false` and `k=10~20` to inspect titles, publication years, citation counts, and venues.112 * **Step 2**: Select the top 1~3 most relevant papers and call `/works/{id}` or re-query with `abstracts=true` only for those specific papers.1133. **Snowballing Literature Reviews**:114 * Identify 1 seminal paper $\rightarrow$ call `/similar/{id}` to discover peer research $\rightarrow$ call `/walk?id={doi}` to capture foundational works cited across the field.1154. **Rate Limits & Etiquette**:116 * Limit: **30 requests per minute per IP address**.117 * Batch parameters into a single request (e.g. `k=30` once rather than multiple `k=5` calls).118 * Respect HTTP 429: read the `Retry-After` header or `retry_after` JSON response field and sleep before retrying.1195. **Citing Papers**:120 * Always cite using the official DOI (`https://doi.org/<doi>`) or OpenAlex URL.121 * To guide human users to an interactive reading view: `https://sciencemadereadable.com/?work=<doi>`.