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-search3description: "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-search6---78# Science Search (ScienceMadeReadable)910Search ~200 million peer-reviewed papers and academic preprints across all fields of science.1112- **Base URL**: `https://api.sciencemadereadable.com/api/data`13- **Authentication**: Free, read-only JSON over HTTPS, no API key required.14- **Reference Doc**: `GET https://api.sciencemadereadable.com/api/data/llms.txt`1516---1718## 1. Quick Invocation (Cross-Platform)1920### Option A: Direct Web Fetch / Agent Fallback (No CLI Required)2122If you only have a web fetching tool (`read_url_content` / HTTP GET), request the plain-text Markdown endpoint directly:2324```text25https://ask.sciencemadereadable.com/<question>26```2728- Spaces can be `%20` or `+` (e.g. `https://ask.sciencemadereadable.com/why%20do%20cats%20purr?k=10&abstracts=false`)29- Accepts standard query parameters: `k` (1–100), `year_from`, `year_to`, `type`, `open_access=true`, `abstracts=false`.3031### Option B: Bundled Python Helper Script (Zero Dependencies)3233Run the bundled script using standard Python (`python3`, `python`, or `uv run`):3435```bash36# Semantic search with token-saving (no abstracts)37python scripts/search_science.py "effect of intermittent fasting on weight loss" --limit 10 --no-abstracts3839# Keyword / Boolean search40python scripts/search_science.py '"gut microbiome" AND autism NOT mice' --limit 54142# Look up paper by DOI or OpenAlex ID43python scripts/search_science.py --work "10.1126/science.aan8048"4445# Find similar papers46python scripts/search_science.py --similar "W2782456798" --limit 54748# Citation walk (what similar papers cite that this paper does not)49python scripts/search_science.py --walk "10.1126/science.aan8048"50```5152### Option C: cURL / Shell5354**Bash (Linux / macOS):**5556```bash57B="https://api.sciencemadereadable.com/api/data"5859# Semantic search60curl -sG "$B/search" --data-urlencode "q=effect of intermittent fasting on weight loss in adults" -d k=10 -d abstracts=false6162# Keyword & boolean search63curl -sG "$B/search" --data-urlencode 'q="gut microbiome" AND (autism OR ASD) NOT mice' -d k=10 -d abstracts=false6465# Paper lookup by DOI66curl -s "$B/works/10.1126/science.aan8048"6768# Similar papers69curl -s "$B/similar/W2782456798?k=10&abstracts=false"7071# Citation walk72curl -s "$B/walk?id=10.1126/science.aan8048"73```7475**PowerShell (Windows):**7677```powershell78$B = "https://api.sciencemadereadable.com/api/data"7980# Semantic search81Invoke-RestMethod -Uri "$B/search?q=effect+of+intermittent+fasting+on+weight+loss+in+adults&k=10&abstracts=false"8283# Paper lookup84Invoke-RestMethod -Uri "$B/works/10.1126/science.aan8048"85```8687---8889## 2. API Endpoints Reference9091| Endpoint | Method | Purpose | Key Parameters |92| -------------------- | ------ | ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |93| `/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`) |94| `/search/{question}` | GET | Plain-text Markdown output of search results | Same query options as `/search` |95| `/works/{ref}` | GET | Full paper record by DOI, W-number, or PMCID | `ref` = DOI (`10.xxx`), OpenAlex ID (`Wxxx`), or PMCID (`PMCxxx`) |96| `/similar/{ref}` | GET | Find papers closest in meaning to a specific paper | `ref`, `k`, `year_from`, `year_to`, `abstracts` |97| `/walk?id={ref}` | GET | Citation walk: find literature that similar papers cite | `id` (DOI or W-number), `k` |9899### Key Result Fields100101- `id`: OpenAlex W-number (e.g. `W2782456798`)102- `doi`: Digital Object Identifier103- `title`: Paper title104- `year` / `date`: Publication date105- `authors`: Authors list (joined by `" | "`)106- `venue` / `publisher`: Journal or conference name107- `citations`: Citation count at snapshot date108- `abstract`: Paper abstract (if `abstracts=true`)109- `score`: Cosine similarity (semantic) or BM25 score (keyword)110- `junk`: Likelihood (0.0–1.0) that the item is spam or non-scholarly111- `openalex`: OpenAlex URL for citation112113---114115## 3. Best Practices for AI Agents1161171. **Academic Phrasing Optimization**:118 - Transform informal questions into academic/scientific phrasing before searching.119 - _Example_: Instead of `"how to cure insomnia"`, search for `"non-pharmacological interventions for chronic insomnia in adults"`. This drastically increases semantic matching precision.1202. **Token Efficiency (Screening Pattern)**:121 - **Step 1**: Search with `abstracts=false` and `k=10~20` to inspect titles, publication years, citation counts, and venues.122 - **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.1233. **Snowballing Literature Reviews**:124 - 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.1254. **Rate Limits & Etiquette**:126 - Limit: **30 requests per minute per IP address**.127 - Batch parameters into a single request (e.g. `k=30` once rather than multiple `k=5` calls).128 - Respect HTTP 429: read the `Retry-After` header or `retry_after` JSON response field and sleep before retrying.1295. **Citing Papers**:130 - Always cite using the official DOI (`https://doi.org/<doi>`) or OpenAlex URL.131 - To guide human users to an interactive reading view: `https://sciencemadereadable.com/?work=<doi>`.