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:

bash

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 forpetsWhole Pets vertical (default starting point)pets-for-saleAnimals offered for sale / rehomingpet-equipment-accessoriesBeds, crates, tanks, filters, etc.bash

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.

bash

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.