Gumtree UK jobs & part-time

Use this skill only for UK employment listings on Gumtree: full-time, part-time, temporary, and casual roles the user describes in natural language. Do not use it for pets, football merchandise, property to buy/rent as housing, or motors.

Prerequisites

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

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 cp from the unpacked bundle root (the folder that contains bb-sites/).

How to turn user input into a search

1. query: combine role + contract hint + optional sector, e.g. evening cleaner Bristol, weekend retail assistant, remote admin part time, warehouse operative night shift.
2. location: city, region, postcode area, or United Kingdom for national scan.
3. page: 1, 2, … for pagination.
4. category: use jobs to stay inside the Jobs vertical. Gumtree exposes subcategories as their own search_category slugs (examples below)—pick one when the user’s sector is clear.

Example job subcategory slugs (confirm on site if results look wrong)

Subcategory slugs change over time—if Gumtree returns unrelated ads, fall back to jobs and a sharper query.

bb-browser site gumtree/search "part time barista" "Edinburgh" 1 jobs --json
bb-browser site gumtree/search "weekend warehouse" "Birmingham" 1 driving-warehouse-jobs --json
bb-browser site gumtree/search "remote data entry" "United Kingdom" 1 jobs --json
bb-browser site gumtree/search "summer festival steward" "Manchester" 1 hospitality-catering-jobs --json

Positional order: query, location, page, category.

Listing detail (full advert text)

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

Encourage users to verify employer identity, right to work, and pay on official channels; the CLI is read-only.

When Gumtree markup changes

Edit bb-sites/gumtree/search.js and listing.js, then re-copy to ~/.bb-browser/sites/gumtree/.

Compliance

Respect Gumtree terms, robots.txt, and polite request rates. Jobs-only skill.