You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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>
Copy file name to clipboardExpand all lines: skills/semantic-scholar/SKILL.md
+1Lines changed: 1 addition & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -305,6 +305,7 @@ for p in r.get("recommendedPapers", []):
305
305
-`corpusId` (integer) is the stable ID for persistent storage — prefer over `paperId` (SHA).
306
306
-`abstract` may be null — Springer journals block abstract delivery.
307
307
- 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.
308
309
-**Batch and recommendations POST endpoints:**`fields` and `limit` must be query params, not in the request body. Body takes only `ids` / `positivePaperIds` / `negativePaperIds`.
309
310
-**Recommendations:** only accepts S2 SHA IDs — `ARXIV:` and other prefixes return 400.
310
311
- Author `affiliations` is self-reported — may be stale.
0 commit comments