Search local businesses on Hotfrog.

Searches the Hotfrog US business directory across the United States like its search page: business name, address, category, phone, website and profile link. First results page only (about 10 businesses). Returns an empty list when nothing matches.

No reports yetRead-only, no login

Site: Hotfrog, United States
Version: v1
Runs, last 7 days: No reports yet
sha256: 32209bab09db…

Run it with your agent

after installing Wield

Ask in plain words. Your agent finds this recipe and calls it:

“Search local businesses on Hotfrog.”

Read-only: it changes nothing on the site. No login needed.

{
  "tool": "run",
  "arguments": {
    "recipe_id": "hotfrog.com/search-places",
    "params": {
      "query": "florist"
    }
  }
}

Requests

sent from your browser, in order

1GET/search/United%20States/{{ params.query | urlencode }}Server-rendered results page /search/United%20States/<query>; read-only GET. Each business is a div.entity card with its name link, address, category and phone link.

Parameters

from your agent

querystringrequiredBusiness type or keyword, e.g. 'florist', 'roofing', 'bakery'

Returns

to your agent

placesobject[]address, category, name, phone, url, website

querystring

Where it can send

www.hotfrog.com

Anything else is blocked by the extension.

Reads from your session

Nothing. Your browser attaches the site's cookies by itself.

Used only in requests to the addresses on the left. Never sent to wield.run or your agent.

Checks

a run passes when

length(output.places) > `0`
length(output.places[?starts_with(url, 'https://www.hotfrog.com/company/')]) == length(output.places)
length(output.places[?name != `null`]) == length(output.places)

Raw recipe

Served as canonical JSON from /api/v1/recipes/hotfrog.com/search-places, so its sha256 matches the ETag and the index.

Check it yourself

curl -s https://wield.run/api/v1/recipes/hotfrog.com/search-places | shasum -a 256
# 32209bab09db3a61cab130fc25d21030dd70690a7b489facfd0d9f349bfdaee8

hotfrog.com/search-places.json, v1

{
  "description": "Searches the Hotfrog US business directory across the United States like its search page: business name, address, category, phone, website and profile link. First results page only (about 10 businesses). Returns an empty list when nothing matches.",
  "effect": "read",
  "id": "hotfrog.com/search-places",
  "keywords": [
    "hotfrog",
    "hotfrog.com",
    "business directory",
    "local business",
    "directory",
    "companies",
    "yellow pages",
    "florist",
    "roofing",
    "bakery",
    "phone number",
    "united states",
    "local services",
    "verzeichnis"
  ],
  "output": {
    "schema": {
      "properties": {
        "places": {
          "items": {
            "properties": {
              "address": {
                "description": "Street, postcode and city as shown on the listing",
                "type": [
                  "string",
                  "null"
                ]
              },
              "category": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "name": {
                "type": "string"
              },
              "phone": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "description": "Hotfrog profile page",
                "type": "string"
              },
              "website": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "name",
              "url"
            ],
            "type": "object"
          },
          "type": "array"
        },
        "query": {
          "type": "string"
        }
      },
      "required": [
        "query",
        "places"
      ],
      "type": "object"
    },
    "value": "{query: params.query, places: steps.search.places[?name != `null` && href != `null`].{name: name, address: (address && trim(address)) || `null`, category: (category && trim(category)) || `null`, phone: (phone && replace(phone, 'tel:', '')) || `null`, website: website || `null`, url: join('', ['https://www.hotfrog.com', href])}}"
  },
  "params": {
    "additionalProperties": false,
    "properties": {
      "query": {
        "description": "Business type or keyword, e.g. 'florist', 'roofing', 'bakery'",
        "maxLength": 100,
        "minLength": 2,
        "type": "string"
      }
    },
    "required": [
      "query"
    ],
    "type": "object"
  },
  "provenance": {
    "method": "har",
    "notes": "One GET to /search/United%20States/<query>, which answers 200 HTML with the first page of business cards (div.entity, 10 per page). No JSON-LD and no JSON API on this page. Name and profile link come from h3.entity-title a; address from p.entity-address; phone from the tel: link; website from a.has-icon--website. Profile links are relative /company/... and are joined to the origin.",
    "recorded_at": "2026-11-08T16:39:39.000Z",
    "recorded_by": "wield-forge (claude-haiku agent)"
  },
  "requires_login": false,
  "schema": "https://wield.run/schema/recipe/v1.json",
  "site": {
    "country": "US",
    "id": "hotfrog.com",
    "language": "en",
    "name": "Hotfrog",
    "origin": "https://www.hotfrog.com",
    "origins": [
      "https://www.hotfrog.com"
    ]
  },
  "steps": [
    {
      "description": "Server-rendered results page /search/United%20States/<query>; read-only GET. Each business is a div.entity card with its name link, address, category and phone link.",
      "expect": {
        "content_type": "html",
        "status": [
          200
        ]
      },
      "extract": {
        "html_items": {
          "places": {
            "fields": {
              "address": {
                "selector": "p.entity-address"
              },
              "category": {
                "selector": "div.entity-categories"
              },
              "href": {
                "attr": "href",
                "selector": "h3.entity-title a"
              },
              "name": {
                "selector": "h3.entity-title a"
              },
              "phone": {
                "attr": "href",
                "selector": "a[href^='tel:']"
              },
              "website": {
                "attr": "href",
                "selector": "a.has-icon--website"
              }
            },
            "max": 30,
            "selector": "div.entity.lm_item"
          }
        }
      },
      "id": "search",
      "request": {
        "headers": {
          "Accept": "text/html"
        },
        "method": "GET",
        "url": "/search/United%20States/{{ params.query | urlencode }}"
      }
    }
  ],
  "task": "Search local businesses on Hotfrog",
  "tos": {
    "notes": "Not reviewed. One search page per call, the same page a visitor loads. The site's terms on automated access were not checked.",
    "reviewed": false
  },
  "verify": {
    "checks": [
      "length(output.places) > `0`",
      "length(output.places[?starts_with(url, 'https://www.hotfrog.com/company/')]) == length(output.places)",
      "length(output.places[?name != `null`]) == length(output.places)"
    ],
    "example_params": {
      "query": "florist"
    },
    "max_ms": 5000
  },
  "version": 1
}