{
  "specVersion": "1.0",
  "host": {
    "displayName": "Nearhood",
    "identifier": "nearhood.co.uk",
    "documentationUrl": "https://nearhood.co.uk/agents.txt",
    "logoUrl": "https://nearhood.co.uk/nearhood_favicon.png"
  },
  "entries": [
    {
      "identifier": "urn:air:nearhood.co.uk:api:local-discovery",
      "displayName": "Nearhood Local Discovery API",
      "type": "application/vnd.oai.openapi+json",
      "url": "https://api.nearhood.co.uk/openapi.json",
      "description": "Read-only discovery of community services, events, and free skill-swap trades across the 33 London boroughs. Every listing is tagged to exactly one borough; there are no national feeds. No authentication required for reads.",
      "tags": [
        "local",
        "community",
        "london",
        "services",
        "events",
        "trades",
        "marketplace",
        "noticeboard",
        "nostr"
      ],
      "capabilities": [
        "search_offerings_by_area",
        "list_service_listings",
        "list_community_events",
        "list_skill_swap_trades",
        "get_offering_by_id"
      ],
      "representativeQueries": [
        "find a plumber near me in Hackney",
        "what community events are happening in Islington this weekend",
        "local people offering dog walking in south London",
        "free skill swaps and service trades in my London borough"
      ],
      "metadata": {
        "network": "nostr",
        "boroughCount": 33,
        "primaryReadEndpoint": "GET https://api.nearhood.co.uk/api/offerings?area={borough}&offering_type={event|service-listing|trade-listing|noticeboard-listing}",
        "offeringTypes": ["event", "noticeboard-listing", "service-listing", "trade-listing"]
      }
    },
    {
      "identifier": "urn:air:nearhood.co.uk:api:publish",
      "displayName": "Nearhood Publishing API",
      "type": "application/vnd.oai.openapi+json",
      "url": "https://api.nearhood.co.uk/openapi.json",
      "description": "Publish service listings, community events, marketplace trades, and digitised physical-noticeboard listings to a London borough. Writes require NIP-98 (Nostr kind-27235) request signing, and user-signed content requires NIP-13 proof of work at 20 leading zero bits. See the agent guide for signing modes and request shapes.",
      "tags": [
        "local",
        "community",
        "london",
        "publish",
        "services",
        "events",
        "trades",
        "nostr"
      ],
      "capabilities": [
        "create_service_listing",
        "create_trade_listing",
        "create_noticeboard_listing",
        "create_community_event"
      ],
      "representativeQueries": [
        "post a service listing for my plumbing business in Hackney",
        "digitise a flyer I found on a local noticeboard",
        "create a community event in Camden",
        "offer to trade graphic design for dog walking"
      ],
      "metadata": {
        "network": "nostr",
        "auth": "NIP-98 (Nostr HTTP auth, kind 27235)",
        "proofOfWork": "NIP-13, 20 leading zero bits on user-signed kind 9000 / 30402 content",
        "agentGuide": "https://nearhood.co.uk/agents.txt",
        "signingModes": {
          "platform-signed-listing": "POST https://api.nearhood.co.uk/api/offerings",
          "user-signed-listing-or-event": "POST https://api.nearhood.co.uk/api/offerings/signed",
          "platform-signed-event": "POST https://api.nearhood.co.uk/api/events"
        }
      }
    }
  ]
}