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:

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 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)#

User intentExample search_categoryGeneral / mixedjobsRetail, shop floorretail-jobsHospitality, bar, kitchenhospitality-catering-jobsOffice, admin, PAsecretary-pa-jobs or office-jobsCustomer service, call centrecustomer-service-call-center-jobsDriving, warehousedriving-warehouse-jobs

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

bash

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)#

bash

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.