pp-walkerplus

Walkerplus event discovery

For a source checkout, use a locally built walkerplus-pp-cli binary with Go 1.26.6 or newer. Catalog installation requires a merged library release. Verify walkerplus-pp-cli --version; if missing, build with go build -o walkerplus-pp-cli ./cmd/walkerplus-pp-cli and make the binary available on PATH. Public Walkerplus HTML is the only runtime source. No credentials, browser, booking, or translation provider is involved. MCP is compiled for stdio only; no HTTP listener is included. When using MCP, inspect truncation metadata and narrow --limit or --select after a bounded result or capture-limit error. CLI JSON error codes remain available; auxiliary diagnostics are separate.

Workflow

Resolve the travel location and event category through the catalogs. Accepted codes and source slugs map to Japanese source labels. City codes, source slugs and Japanese city names from areas are accepted with the matching prefecture; for example, --prefecture tokyo --city ar0313104 or --city shinjuku.
```
walkerplus-pp-cli areas --prefecture kyoto
walkerplus-pp-cli categories
```
Discover bounded candidates cheaply. Search reads listings only. Use exact trip dates and inspect coverage before describing completeness.

walkerplus-pp-cli search --prefecture kyoto --category festival --from 2026-10-01 --to 2026-10-31 --limit 5 --max-pages 3

Enrich a bounded shortlist when the traveler needs attendance confidence or strict constraints. Keep possible matches separate from confirmed days.
```
walkerplus-pp-cli shortlist --prefecture kyoto --from 2026-10-10 --to 2026-10-12 --max-details 10 --agent --select id,title_ja,start_date,end_date,location,match,schedule,sources
walkerplus-pp-cli shortlist --prefecture osaka --from 2026-10-11 --to 2026-10-11 --indoor --max-details 10
```
--free requires explicit event admission evidence; --indoor requires unconditional indoor evidence. Both flags mean AND. Optional paid purchases do not make explicitly free admission paid; preserve those caveats. Unknown and conditional source attributes are excluded by strict constraints.
Read the event edition before recommending attendance. Carry schedule exceptions, weather, cancellation, admission and reservation facts into the answer with its source URL.
```
walkerplus-pp-cli event ar0313e603640 --select id,title_ja,source_url,schedule,hours,admission,reservation_required,reservation_text,weather,cancellation,organizer_urls,sources
```
Completion means every recommendation cites the edition, relevant source dates, match confidence, practical caveats, and coverage limits. If published evidence does not resolve attendance, describe it as possible and direct the traveler to the organizer.

Evidence and bounds

Japanese titles are authoritative. Raw schedule, admission and reservation text, evidence, and source URLs are source facts. Normalized edition_year/date_certainty, parsed recurrence/exclusion lists, admission status, boolean classifications, and match/rank fields are derived conveniences. An overall date envelope is not proof of daily activity. Closure-only rules narrow possible days; explicit occurrences, daily activity or positive recurrence can confirm activity. Approximate seasons, unresolved holiday exceptions, and undisclosed next-year editions never become confirmed dates. --timing starts|ends checks published envelope boundaries.

JSON is compact by default; --agent and --json are compatible. --select/--fields project event fields while retaining query, coverage and provenance. Use schema to discover fields. Unknown scalars are null, collections are empty arrays, diagnostics are stderr.

Default caps are 10 returned events, 3 listing pages, and 10 detail candidates. Shortlist returns only detail-inspected candidates; reaching --max-details can leave fewer results than --limit. Detail selection checks listing-supported location/category matches before candidates with missing facts, using --sort within each group; returned results use --sort. Widen --max-pages and --max-details deliberately within hard limits; an empty bounded scan does not establish absence. Coverage gives sampled routes, counts, continuation, cache hits and incomplete reasons. Resolving an additional city performs at most one prefecture catalog lookup outside the --max-pages event-page budget; catalog_requests/catalog_routes record it, and request_count includes it. Native month/day routes have no year selector; exact local filtering cannot manufacture a future edition.

Use --refresh when a source recheck is needed. sources provide fetch time and cache age; publisher update text is separate. Every custom command accepts --dry-run for offline validation.

walkerplus-pp-cli doctor --dry-run --json
walkerplus-pp-cli event --dry-run --agent

Usage errors exit 2, missing event 3, fetch/parser failure 5, exhausted rate limiting 7. Source failure emits JSON error rather than empty success. Read README.md for build, cache, troubleshooting and live verification details.

Catalog availability

Use the installer section below when Walkerplus is available in the Printing Press catalog. For a source checkout or when catalog installation is unavailable, build and verify locally using the instructions above.

Prerequisites: Install the CLI

This skill drives the walkerplus-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:
```
npx -y @mvanhorn/printing-press-library install walkerplus --cli-only
```
Verify: walkerplus-pp-cli --version
Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

go install github.com/mvanhorn/printing-press-library/library/travel/walkerplus/cmd/walkerplus-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

Build a bounded shortlist from Walkerplus while preserving Japanese event titles and uncertainty. Inspect details before committing travel time.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Trip discovery

shortlist — Find exact-edition trip candidates with schedule confidence, constraints and explainable ranking.

Use for a bounded event shortlist tailored to trip dates and practical constraints.
```
walkerplus-pp-cli shortlist --prefecture kyoto --from 2026-10-10 --to 2026-10-12 --max-pages 1 --max-details 3 --limit 3
```

Recipes

Trip shortlist

walkerplus-pp-cli shortlist --prefecture kyoto --from 2026-10-10 --to 2026-10-12 --limit 5

Enrich bounded candidates and explain schedule confidence.

Compact candidate scan

walkerplus-pp-cli search --prefecture tokyo --from 2026-10-01 --to 2026-10-07 --agent --select id,title_ja,source_url

Keep event output small while retaining coverage metadata.

Event facts

walkerplus-pp-cli event ar0313e603640

Read source schedule, access, pricing and reservation facts.

Auth Setup

Public Walkerplus HTML; no API key or login required.

Run walkerplus-pp-cli doctor to verify setup.