Skip to content

Commit 13cbfd6

Browse files
bisonclaude
andcommitted
feat(semantic-scholar): document bulk search pool saturation gotcha
Add gotcha noting search_papers_bulk saturates the shared unauthenticated pool — requires ≥10s delay before the next call to avoid exhausting retries. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent ccb7ced commit 13cbfd6

1 file changed

Lines changed: 1 addition & 0 deletions

File tree

skills/semantic-scholar/SKILL.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -305,6 +305,7 @@ for p in r.get("recommendedPapers", []):
305305
- `corpusId` (integer) is the stable ID for persistent storage — prefer over `paperId` (SHA).
306306
- `abstract` may be null — Springer journals block abstract delivery.
307307
- Bulk search uses token pagination only — pass `token` from response back as query param. `null` token = end of results.
308+
- `search_papers_bulk` is the heaviest endpoint — it saturates the shared pool more than any other call. Always add a delay (≥10s) before the next request after a bulk search to avoid exhausting all retry attempts.
308309
- **Batch and recommendations POST endpoints:** `fields` and `limit` must be query params, not in the request body. Body takes only `ids` / `positivePaperIds` / `negativePaperIds`.
309310
- **Recommendations:** only accepts S2 SHA IDs — `ARXIV:` and other prefixes return 400.
310311
- Author `affiliations` is self-reported — may be stale.

0 commit comments

Comments
 (0)