Event Sources

Berlin Event Sources

A curated directory of Berlin event sources with validated Readability status and qurl ingestion commands. Full source details (URLs, RSS, API docs, language notes) are in references/sources.md.

qurl Ingestion

The standard ingestion command for any registered source:

PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-plugins/berlin-events}"
BUN=$(command -v bun 2>/dev/null || echo "$HOME/.bun/bin/bun")

"$BUN" run "$PLUGIN_ROOT/scripts/extract-events.ts" "<slug-or-url>" \
  | qurl add "<canonical-url>" --source berlin-events --tags <art|food|art,food>

For all registered sources, keep qurl writes sequential:

while IFS=$'\t' read -r slug url category _kind; do
  [[ -z "$slug" ]] && continue
  "$BUN" run "$PLUGIN_ROOT/scripts/extract-events.ts" "$slug" \
    | qurl add "$url" --source berlin-events --tags "$category"
done < <("$BUN" run "$PLUGIN_ROOT/scripts/list-sources.ts")

After ingesting all sources, embed and search:

qurl embed
# Primary: `qurl search` (pure BM25, honors --source/--tag/--limit).
# Keep the query SHORT (3-5 words) — BM25 needs term overlap, so a
# verbose keyword-stuffed query returns "No results".
qurl search "Berlin art exhibition opening" --source berlin-events --limit 20

Choose the qurl command by behaviour (verified against qurl source):

• qurl search — pure BM25 keyword (FTS5); exact terms, needs term overlap. Honors --source/--tag/--limit.
• qurl query — alias for search (identical, pure BM25). Not hybrid/rerank despite the name.
• qurl vsearch — pure vector/semantic; tolerates verbose queries, honors --limit, but ignores --source/--tag (whole DB) — grep hosts to filter.

For broad recall with a verbose query, use vsearch + a host grep:

qurl vsearch "$(date '+%B %Y') Berlin exhibition opening vernissage workshop event calendar art food" 2>&1 \
  | grep -E -i 'indexberlin|kw-berlin|berlinischegalerie|artatberlin|co-berlin|kunstleben-berlin|berlin\.de|visitberlin'

Use qurl, not qmd. qurl is the event-scrape DB. qmd is a separate notes search engine and holds no events — never substitute it here, despite shared subcommand names.

Registered Sources

The source registry in scripts/sources.ts is the canonical ingestion list. It routes sources through Readability, generic Playwright rendering, or source-specific Playwright extractors.

Use bun run scripts/list-sources.ts to print slug, canonical URL, category, and strategy.

Relevance Keywords

A query result is relevant if its snippet contains any of:

• EN dates/events: april, may, monday–sunday, vernissage, opening, exhibition, finissage
• DE events: ausstellung, veranstaltung, führung, kalender, programm
• Date patterns: 2026, .04.26, .05.26

Source-Specific Extractors

These sources previously failed or produced low-signal output with Readability alone. They are now registered with Playwright-backed source extractors plus rendered-text fallback:

If Playwright reports a missing browser executable, run:

cd "$PLUGIN_ROOT/scripts" && bunx playwright install chromium

Reference Files

• references/sources.md — Full source directory with URLs, RSS, API docs, Readability status, and ingestion notes for each source