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

bb-browser (npm i -g bb-browser).
This bundle includes bb-sites/gumtree/search.js and bb-sites/gumtree/listing.js. Install into bb-browser:

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_category | Use for | |-------------------|---------| | pets | Whole Pets vertical (default starting point) | | pets-for-sale | Animals offered for sale / rehoming | | pet-equipment-accessories | Beds, 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.