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.md

GitHub

Bluesky 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 search
  • feed 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.social is a band, not the weather service. Run profile and check the description/domain handle. A handle on the organisation's own domain, such as metservice.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