Craigslist Search Radius Quick Adjust

WHAT IT DOES

This script adds quick-adjust radius buttons to Craigslist search pages, letting you change the search radius without navigating to the search form. When you search on Craigslist, preset buttons (5mi, 10mi, 25mi, 50mi, 100mi, 200mi) appear near the search results. Click any button to instantly update the search radius and reload the page with the new radius applied. A "Clear" button removes the radius filter entirely. The current radius is highlighted, so you always know which radius is active. The script works on both the main search page and "nearby" search results. Your last used radius is stored locally, and you can set a default radius in the settings panel.

WHERE IT RUNS

The script runs on all Craigslist pages (*.craigslist.org). It works on search results pages, category pages, and any page with search parameters. It supports both desktop and mobile views.

HOW TO USE

After installation, the settings panel appears on the left side of the screen with the gear emoji (⚙️). Open the panel to configure the script:

- The "Enable radius quick adjust" toggle enables or disables the buttons.

- Set a "Default radius" to control the initial radius when the script loads.

- Click any preset radius button (5mi, 10mi, 25mi, 50mi, 100mi, 200mi) to apply that radius.

- Click "Clear radius filter" to remove the radius filter and show all results.

The radius buttons appear automatically on search pages. Clicking a button updates the URL and reloads the page.

TECHNICAL SECTION — REAL MECHANISM

The script detects Craigslist search pages by checking the URL for /search/, /s/, /results/, /browse/, or '?'. It extracts the current radius from the URL's srchRadius parameter using regex. The radius buttons are created as a flex container with styled buttons for each preset radius. The container is inserted near the search form or results using DOM insertion. When a button is clicked, the script constructs a new URL by updating the srchRadius parameter and reloads the page using window.location.href. The "Clear" button removes the srchRadius parameter entirely. The current radius is highlighted by applying different styles to the active button. The default radius is stored via GM_setValue and used as the initial radius when no radius is set in the URL. A MutationObserver watches for DOM changes and re-creates the buttons when the page updates.

THE PANEL

The settings panel is built with BotGentz's BGPanel component. It is draggable via its header, allowing you to reposition it anywhere on the screen. The panel snaps to the left edge by default but can be moved freely. Click the gear emoji to collapse the panel into a small bubble, and click the bubble to expand it again. The panel remembers its position per page session. Press the Escape key to quickly close or minimize the panel. The panel includes a status flash bar that provides visual feedback when settings are changed or actions are performed. All settings save automatically via GM_setValue.

PLEASE NOTE

This script requires the free BotGentz browser extension to run. It does not function as a standalone Chrome extension and does not use chrome.* APIs. Craigslist frequently updates its page structure, which may affect where the radius buttons are inserted. If the buttons stop appearing, please check for updates. The script reloads the page when a radius is selected—this is necessary because Craigslist uses server-side search. The script stores only your preferences via GM_setValue. No data is sent externally—all data is stored locally in your browser. The script never reads or writes password fields, hidden inputs, or file inputs. All DOM operations use safe methods (style properties, textContent, appendChild) and never use innerHTML.