Skip to content

v0.8.1 — rate-limit hardening, docs polish, brand refresh

Latest
Latest

Choose a tag to compare

View all tags
@Agents365-ai Agents365-ai released this 10 May 02:01
v0.8.1
e32c1eb

This rolls up the v0.8.0 feature work (which was committed but never tagged) plus a follow-up rate-limit fix and a docs refresh.

✨ Highlights since v0.6.0

Features (from v0.8.0 work)

  • No-key fallback — the skill now works without S2_API_KEY. When the key is absent or rejected (403), s2.py switches to unauthenticated mode automatically.
  • Fuzzy + proximity search — build_bool_query() now supports fuzzy=[(term, edit_distance)] and proximity=[(phrase, word_distance)] for sloppy phrase matching ("blue lake"~3) and edit-distance term matching (bugs~3).
  • Datasets API — new helpers list_releases(), list_datasets(), get_dataset_links(), get_dataset_diffs() for bulk-downloading the full S2 corpus (papers, abstracts, embeddings, citations, etc.) as JSON Lines.
  • Full tutorial-style documentation in SKILL.md: 4-phase workflow, decision tree, worked examples, troubleshooting matrix, full filter and sort reference.

Fixes

  • Widened unauthenticated rate-limit gap from 3 s → 5 s. Per S2 docs, the anonymous pool is 1000 req/s shared globally and "may be further throttled during periods of heavy use" — the larger gap protects against the heavy-use throttling that the steady-state pool number would obscure.

Docs

  • Rate-limit description corrected to match the official policy: anonymous = 1000 req/s shared globally, authenticated = introductory 1 req/s dedicated quota (raisable on request, cumulative across all endpoints).
  • README brand refresh — new title: "the easiest way to search the scientific literature".
  • Discord invite added alongside the WeChat QR in the Community section: https://discord.gg/79JF5Atuk
  • Semantic Scholar API Tutorial link added to README headers.

🛠 Behavior change

If you were relying on the 3 s anonymous gap, the default is now 5 s. If your workload was already happy with 3 s, you can override _MIN_GAP in s2.py. If you were hitting 429s on the shared pool, the new default should fix it; if not, raise it to 10 s.

📦 Install

npx skills add Agents365-ai/365-skills -g
# or update an existing install
git -C ~/.claude/plugins/cache/365-skills/semanticscholar/0.8.1 pull

Full changelog: v0.6.0...v0.8.1

Assets 2
Loading