Gumtree Browser Automation Skill for Openclaw

A powerful browser automation skill that connects a local Python CLI with a Chrome extension to automate search, messaging, account details, and ad flows on Gumtree.

bluebluebbb
v1.0.0
May 25, 2026
1
688
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install gt-core-skill

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install gt-core-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Gumtree Browser Automation Skill?

The Gumtree Automation Skill is designed to bridge the gap between AI coding agents and live web interaction. By leveraging a local WebSocket bridge server and a dedicated Chrome extension, this skill allows users to execute browser-driven tasks directly on Gumtree. Unlike fragile HTTP scraping, this integration interacts with a real Chrome session, allowing you to accurately fetch real-time recommendations, manage favourites, handle messages, and even kickstart the listing creation process. This level of reliable web automation makes it one of the most practical Openclaw Skills available for classified market monitoring and management.

Whether you need to monitor new listings with specific filters or handle customer communications directly from your workspace, this tool translates simple CLI instructions into exact browser actions. Because it relies on actual session states and page-embedded JavaScript configurations, it bypasses traditional scraping blocks, providing you with high-quality, structured JSON responses for downstream AI agent workflows.

Gumtree Browser Automation Skill Use Cases

  • Automate searches on Gumtree with precise filters like location, price range, condition, and sorting methods.
  • Track and update your favourited listings directly in a logged-in browser session.
  • Manage buyer and seller interactions by sending and reading messages programmatically.
  • Start the initial post-ad category selection flow based on keywords.
  • Scrape rich, authenticated listing data securely using your active Chrome session within the Openclaw Skills ecosystem.

How Gumtree Browser Automation Skill Works

  1. Triggering CLI Commands: The AI agent or user executes a command using uv run python scripts/cli.py or the gumtree-skills entrypoint.
  2. Establishing Connection: The CLI checks for an active local WebSocket bridge server and connects to the running Google Chrome extension.
  3. Browser Automation: The Chrome extension interacts directly with the live browser DOM, mimicking organic user behavior to navigate, search, or click elements.
  4. Data Extraction: The script reads deep page data, prioritizing embedded JavaScript configurations (like window.clientData or analytics configs) for maximum accuracy.
  5. Structured Return: The CLI outputs structured JSON data to stdout and exits, passing reliable classified data back to the core Openclaw Skills environment.

Gumtree Browser Automation Skill Setup

Ensure you have Python 3.11+, uv, and Google Chrome installed. Navigate to the project root directory before executing setup.

First-time installation:

uv sync

Configure the Chrome Extension:

  1. Open Google Chrome and navigate to chrome://extensions/.
  2. Enable Developer Mode (toggle in the top-right corner).
  3. Click 'Load unpacked' and select the extension/ folder inside this skill repository.
  4. Confirm that the 'Gumtree Bridge' extension is active and enabled.

Run your first automated task using Openclaw Skills:

uv run python scripts/cli.py check-login

Gumtree Browser Automation Skill Data Schema & Taxonomy

This skill processes and returns structured JSON datasets. It leverages embedded page data to extract clean metadata.

Command Category Extracted Data Fields Key Source / Target
Login State loggedIn, session configurations window.clientData, initialDataLayer
Search listing ID, title, price, location, URL DOM / Search API Response
Favourites adverts list, favourite status flags window.clientData.favouriteAds.adverts
Messages conversationId, messages list, sender https://www.gumtree.com/manage/messages
Post-Ad categoryId, suggested categories Category Suggestion API

All commands exit with code 0 on success with valid JSON output, or code 2 on execution failure.

Gumtree Browser Automation Skill Advanced Features

  • Session-Embedded Verification: Reads underlying JS data frameworks like __GUMTREE_ANALYTICS_CONFIG__ and gumtreeDataLayer instead of unreliable HTML scraping.
  • Fuzzy Category Matching: Helps users quickly find the ideal listing category via name-based search or direct indexing.
  • Full Conversation Isolation: Target specific buyers or sellers directly via unique --conversation-id parameters.
  • Extensible WebSockets: Communicates through a secure local bridge enabling rapid custom automation hooks with other Openclaw Skills.
  • Advanced Search Modifiers: Deep support for item colour, mobile model, mobile storage capacity, and customized seller types.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*