bluesky-nz
Search public Bluesky posts and read public account feeds through the no-login Bluesky AppView API, tuned for New Zealand situational awareness: keyword and phrase search with recency sort, author fee
SKILL.mdskills/bluesky-nz/SKILL.md
GitHubBluesky NZ
Goal
Search public Bluesky posts and read public account feeds through the keyless AppView API — a public social signal channel for detecting emerging NZ events (weather impacts, outages, community reports) and monitoring official accounts.
Use this when
- A task needs to scan public social media for emerging NZ incident reports
- A task needs recent public posts from a specific Bluesky account
- A workflow needs machine-readable public post data with engagement counts
Do not use this for
- Posting, liking, following, DMs, or anything requiring a session
- Private/protected content (only public posts are visible)
- Treating crowd posts as verified fact — corroborate against official sources
Commands
python3 skills/bluesky-nz/scripts/cli.py search "wellington south coast waves" --limit 20 --json
python3 skills/bluesky-nz/scripts/cli.py search "state of emergency" --since 2026-07-21 --lang en
python3 skills/bluesky-nz/scripts/cli.py feed metservice.com --limit 10
python3 skills/bluesky-nz/scripts/cli.py profile some-account.bsky.social
search QUERY [--sort latest|top] [--since ISO] [--lang CODE] [--limit N] [--json]— public post searchfeed HANDLE [--limit N] [--json]— recent public posts from one account (replies excluded)profile HANDLE [--json]— public profile summary
Notes
- Craft NZ-specific queries. Generic terms collide with overseas places — "wellington weather" surfaces Wellington, Ohio. Add NZ anchors: suburb names, "NZ", "Aotearoa", agency names.
- Verify handles before trusting an account. Handles are self-registered:
metservice.bsky.socialis a band, not the weather service. Runprofileand check the description/domain handle. A handle on the organisation's own domain, such asmetservice.com, is domain-verified. - Crowd posts are unverified by definition; the JSON output carries this warning.
- Timestamps are UTC as published. Post URLs link to the public web app.
Resources
- CLI entrypoint:
scripts/cli.py - Contract test:
scripts/test_contract.py; smoke test:scripts/smoke_test.py - Endpoint behaviour and rate-limit notes:
references/source-notes.md