Search digitized Swedish historical newspapers (17th century to circa 1908–1910).
Performs OCR full-text search and returns page-level hits with highlighted snippets and image links.

Historical Search & OCR Strategies:
- Fraktur / Gothic Print: 17th to late 19th-century newspapers were mostly printed in Fraktur/blackletter.
  OCR engines frequently confuse similar glyphs (e.g. long 's' [ſ] misread as 'f', 'S', or 'l'; 'c' for 'e'; 'rn' for 'm').
- Historical Spelling & Wildcards: Use wildcard '*' or Boolean 'OR' to catch spelling variations
  (e.g. 'Carlscrona OR Karlskrona', 'Gustaf OR Gustav', 'Linné OR Linnaeus', or stem wildcards like 'Söder*').
- Two-Stage Workflow:
    1. Use this tool ('search_newspapers') for initial discovery of dates, issues, and page numbers.
    2. If snippets are cut off or you need surrounding sentences (e.g. destinations, causes of death, full names),
       call 'search_in_issue(package_id=..., query=...)' on the matched issue to retrieve complete verbatim quotes.
    3. Always present the 'images.preview_width' link so users can visually verify the scanned page if OCR is unclear.

Args:
    query: Search term or phrase in Swedish/English (e.g. 'ångfartyg', 'Carl von Linné', 'brand i Karlskrona').
    from_date: Start date in 'YYYY-MM-DD' format or simply year 'YYYY' (e.g. '1850').
    to_date: End date in 'YYYY-MM-DD' format or simply year 'YYYY' (e.g. '1899').
    newspaper: Filter by specific newspaper title (e.g. 'Aftonbladet', 'Dagens Nyheter', 'Post- och inrikes tidningar', 'Göteborgsposten').
    sort_by: Sort order: 'relevance' (most relevant), 'date_asc' (oldest first), or 'date_desc' (newest first).
    limit: Number of results to return per page (1-100, default 20).
    offset: Zero-based starting index for pagination (default 0).
    max_snippets: Maximum number of text snippets to include per newspaper page (default 5).

Get the temporal or newspaper distribution statistics for a search term.
Useful to discover when an event was reported most frequently or which newspapers covered it.

Args:
    query: Search term (e.g. 'kolera', 'ångbåt', 'Sveriges riksdag').
    field: Aggregation target: 'datePublished' (distribution by year) or 'isPartOf' (distribution by newspaper title).

Search inside a specific newspaper issue to locate all occurrences of a word or phrase
with exact text lines and coordinates for image highlighting (IIIF Content Search).

Two-Stage Workflow Usage:
Use this tool as Stage 2 after 'search_newspapers' whenever a snippet is cut off or you need
the complete surrounding sentence (e.g. to uncover full names, occupations, causes of death,
travel origins/destinations, or accompanying persons).

Args:
    package_id: The package ID of the newspaper issue (e.g. 'dark-37858').
    query: Search word or phrase to locate within the issue.

Generate direct image URLs and IIIF links for a specific newspaper page.

Args:
    image_service_id: IIIF image service URL returned from search_newspapers (e.g. 'https://data.kb.se/iiif/3/dark-30466%2Fbib4345612_18620716_0_s_0003.jp2').
    package_id: Package ID of the newspaper issue (e.g. 'dark-30466' or 'dark-37858').
    page_number: Page number within the issue (e.g. 1, 3, 4).
    part_number: Part/section number (default 1).
    width: Desired pixel width for the preview image (e.g. 1200 for readable size, 300 for thumbnail).

Convert bidirectionally between the National Library's internal package ID (e.g. 'dark-37858')
and the public web URL on tidningar.kb.se (e.g. 'https://tidningar.kb.se/dxqth86q2n2zwg9').

Args:
    id_or_url: A data.kb.se package ID, or a URL/ID from tidningar.kb.se.