agentleFS
taivoptaivop/marketplace/skills/ester/SKILL.md

ester

Skill17 starsChanged 56 days agoMITView on GitHub

Searches the Estonian library catalog ESTER (ester.ee) to find books, check availability, and locate them in specific library branches. USE WHEN user asks to find a book in Estonian libraries, check if a book is available, find where to pick up a library book, search ESTER, or mentions Estonian library branches like Kalamaja, Keskraamatukogu, Tartu, etc.

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Search the Estonian unified library catalog (ESTER) to find books and check their availability at specific branches.

    line 15
  2. Very specific:

    Use keyword (X) for title and author queries too — it handles them well.

    line 37

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

ESTER Library Catalog Search

Search the Estonian unified library catalog (ESTER) to find books and check their availability at specific branches. No public API — uses curl + HTML parsing.

Parser scripts are in this skill directory (relative to SKILL.md).

Workflow

1. Search for books

curl -s "https://www.ester.ee/search~S1*est/X?searchtype=X&searcharg=QUERY&searchscope=SCOPE&SORT=DZ&extended=0&SUBMIT=OTSI" \
  | python3 SKILL_DIR/parse_search.py

Replace QUERY with URL-encoded search terms (ä=%C3%A4, ö=%C3%B6, ü=%C3%BC, õ=%C3%B5, spaces=+).

Search types (replace X in both URL path and searchtype=):

CodeField
XKeyword (all fields) — default
iISBN/ISSN

Use keyword (X) for title and author queries too — it handles them well. Do not use searchtype=t (title) or searchtype=a (author): ESTER returns a browse-heading index page for those, not a results list, and the parser will report 0 results even when matches exist.

searchscope values:

ScopeLibrary
1All libraries (default)
7Eesti Rahvusraamatukogu (National Library)
8Tallinna Raamatukogud / TlnRK (all Tallinn public library branches)
15TLÜ Akadeemiline Raamatukogu
55Tartu Linnaraamatukogu
58Tartu Ülikooli raamatukogud

Output: JSON with total count and results array of {id, title}. If an ISBN search redirects directly to a record page, output includes "direct_record": true.

Pagination: 50 results per page. Add &startnum=51 for page 2.

2. Get holdings for a book

Step 1 — Fetch the record page and check for truncation:

curl -s "https://www.ester.ee/record=b{RECORD_ID}~S1*est" \
  | python3 SKILL_DIR/parse_record.py

Step 2 — If output contains "truncated": true, fetch the full holdings using the full_holdings_url from the output:

curl -s "FULL_HOLDINGS_URL" \
  | python3 SKILL_DIR/parse_record.py

The record page only shows the first 10 holdings. Always check for truncation — popular books often have 30-50+ copies across branches.

Output: JSON with title, author, published, isbn, holdings array of {location, call_number, status, notes}, and optionally truncated/full_holdings_url.

Status values:

  • KOHAL — available on shelf
  • TÄHTAEG DD.MM.YY — checked out, due date
  • TÖÖTLUSES — being processed, not yet available
  • KOHALKASUTUS — in-library use only
  • ARHIIVEKSEMPLAR — archive copy
  • EI LAENUTATA — non-circulating
  • REMONDI AJAKS PAKITUD — packed away during renovation
  • +N JÄRJEKORRAS — N people in queue (appended to due date)

3. Present results

For each book, show:

  • Title, author, year
  • Holdings filtered to user's preferred branch(es), with status and call number
  • ESTER link: https://www.ester.ee/record=b{RECORD_ID}~S1*est

For multiple books, show a summary table of availability per branch.

Tallinn public library branches (TlnRK)

User saysESTER location contains
KalamajaTlnRK Kalamaja
Keskraamatukogu / mainTlnRK Keskraamatukogu
Südalinn / city centerTlnRK Südalinna
LiivalaiaTlnRK Liivalaia
Pelgulinn / PelgurannaTlnRK Pelguranna
NõmmeTlnRK Nõmme
MustamäeTlnRK Mustamäe
ÕismäeTlnRK Väike-Õismäe
PiritaTlnRK Pirita
KadriorgTlnRK Kadrioru
PääskülaTlnRK Pääsküla

Children's sections are listed separately with "lastekirjandus" suffix. Children's books have call numbers starting with L-.

Extra metadata (age group, description, price)

For info not in ESTER (age group, description, price, series), use WebSearch for the book title + author with allowed_domains: ["rahvaraamat.ee", "apollo.ee"]. Use title + author, not ISBN — ISBN search is unreliable on these stores.

Tips

  • Keyword search (searchtype=X) is forgiving with word order — use it for all freetext queries.
  • Boolean operators work: AND, OR, NOT.
  • For multiple books, batch all searches first, then fetch records for matches.
  • searchscope filters search results but the record/holdings page always shows ALL libraries' copies. Filter the holdings JSON by location to show only relevant branches.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.