Meet-Pets-Friends❤️

Data & APIs

Search [Gumtree UK](https://www.gumtree.com/) Pets listings with bb-browser—dogs, cats, small furries, reptiles, horses, pet equipment—structured JSON and first-image Markdown for comparing ads. Uses gumtree/search + gumtree/listing adapters with search_category scoped to pets; for UK seasonal pet trade (e.g. June peak) and responsible buy/sell workflows only. Requires bb-browser.

Install

openclaw skills install gumtree-uk-pets

Meet Pets Friends

Use this skill only for UK pet classifieds on Gumtree: buying or selling animals, pet accessories, and equipment—not property, motors, general for-sale, jobs, or sports.

Seasonal context (UK)

Demand for puppies, kittens, and rehoming often peaks around late spring and June. Help users compare listings (price, location, description, photos) and research sellers—not to bypass Gumtree messaging, identity checks, or the law.

Legal and welfare (must follow)

  • UK law: Animal Welfare Act 2006, breeding/licensing rules where they apply, and banned breeds restrictions—do not advise evading them.
  • Gumtree rules: follow Gumtree pet policies and age/transport requirements; encourage in-person viewing and verifiable documentation (microchip, vet records) where relevant.
  • Read-only CLI: this skill covers gumtree/search and gumtree/listing only. Contacting sellers or posting ads needs the normal site or browser.

Prerequisites

mkdir -p ~/.bb-browser/sites/gumtree
cp bb-sites/gumtree/search.js ~/.bb-browser/sites/gumtree/search.js
cp bb-sites/gumtree/listing.js ~/.bb-browser/sites/gumtree/listing.js

Run the cp commands from the directory that contains bb-sites/ (the unpacked skill bundle root).


Search: keep results inside Pets

4th positional on gumtree/search is Gumtree search_category. For pets, use one of:

search_categoryUse for
petsWhole Pets vertical (default starting point)
pets-for-saleAnimals offered for sale / rehoming
pet-equipment-accessoriesBeds, crates, tanks, filters, etc.
bb-browser site gumtree/search "cocker spaniel puppies" "Manchester" 1 pets --json
bb-browser site gumtree/search "indoor rabbit hutch" "Birmingham" 1 pet-equipment-accessories --json
bb-browser site gumtree/search "KC registered labrador" "United Kingdom" 1 pets-for-sale --json

Positional order (bb-browser): query, location, page, category.

  • Refine query with breed, age (“8 weeks”), “rehome”, “rescue”, accessories type, etc.
  • location: city, region, or United Kingdom.

Each hit includes url, title, price, location, snippet, firstImageUrl, firstImageMarkdown—use gumtree/listing on any url for full description and all images.

bb-browser site gumtree/listing "https://www.gumtree.com/p/dogs/..." --json

When Gumtree markup changes

Update selectors in bb-sites/gumtree/search.js and listing.js, then copy the edited files to ~/.bb-browser/sites/gumtree/ again.

Compliance

Respect Gumtree terms, robots.txt, and polite request rates. This skill is pets-only; use other skills for non-pet categories.