pin-seeker

Search golf tee times and deals near a city, ZIP, or course. Use when the user wants to play golf, find cheap or weekend tee times, compare GolfNow prices, or book a round. You do not need a GolfNow course ID.

Pin Seeker searches public GolfNow inventory from a natural-language request. You do not need a GolfNow FacilityId or course page — a city, ZIP, or course name is enough.

It cannot book, hold, reserve, or pay. After you find times, give the golfer the GolfNow URL. They finish checkout on GolfNow.

When to use

• "Find me a tee time Saturday morning near Pleasanton"
• "What's available at Callippe tomorrow for 2?"
• "Cheapest 18-hole round this weekend within 25 miles of 94566"
• Deals, twilight, or comparing courses in an area

Do not use this skill to claim a reservation, take payment, or modify a booking.

Setup

Installing this skill is enough. Search by calling Pin Seeker's hosted API (or the bundled script). MCP is optional for other clients.

bash

openclaw skills install @rkrishnakumar/pin-seeker

Production search:

• https://pinseeker.xyz/api/agent/search
• Optional MCP: https://pinseeker.xyz/mcp (search_tee_times)

How to search

1. If the golfer omitted a location (city, ZIP, or course name) or when, ask before searching. Do not invent a city. Do not ask for a GolfNow FacilityId.
2. Prefer the search_tee_times MCP tool if it is already connected.
3. Otherwise search with curl or search.sh in this skill folder:

bash

curl -sG "https://pinseeker.xyz/api/agent/search" \
  --data-urlencode "query=Saturday morning near Pleasanton for 2" \
  --data-urlencode "timezone=America/Los_Angeles"

bash

./search.sh "Saturday morning near Pleasanton for 2" America/Los_Angeles

Pass userTimezone / timezone (IANA, e.g. America/Los_Angeles) when you know it. The JSON text field (or format=text) is what you relay.

4. Present a shortlist (best 3–5). Put hot deals first. Each option must include course, time, price, and the GolfNow link. Include distance and rating when the result has them.
5. Stop. Wait for the golfer to book on GolfNow. Never say you booked or held a time.

Reply format

text

Here are some times. Pin Seeker can't reserve them — open a GolfNow link to book.

Hot deals
1. Course — City, ST · 3.1 mi · ★ 4.5
   7:48 AM · $39 · 2 spots · hot deal
   GolfNow: https://www.golfnow.com/...

Other times
2. Course — City, ST · 8.0 mi · ★ 3.9
   10:00 AM · $95 · 4 spots
   GolfNow: https://www.golfnow.com/...

Example

User: "Can you get me on somewhere Saturday morning near Dublin, 2 players?"

Search with query "Saturday morning near Dublin CA for 2".

Then shortlist with GolfNow links. Do not say the time is booked.