Find Job UK

Search [Gumtree UK](https://www.gumtree.com/) jobs and part-time listings with bb-browser from the user’s role, location, and hours—structured JSON plus first-image Markdown for scanning vacancies. Uses gumtree/search + gumtree/listing with search_category jobs (and optional job subcategory slugs). Not for pets, property sales, motors, or football collectibles. Requires bb-browser.

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 intent	Example search_category
General / mixed	jobs
Retail, shop floor	retail-jobs
Hospitality, bar, kitchen	hospitality-catering-jobs
Office, admin, PA	secretary-pa-jobs or office-jobs
Customer service, call centre	customer-service-call-center-jobs
Driving, warehouse	driving-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.