PistonPry is a Chrome extension for extracting visible links, images, and contacts from a page region, a picked set of elements, or the full page.

• Draw a region on any page and extract visible items inside it.
• Pick individual links with Alt+Click.
• Extract all visible items from the current page with the keyboard shortcut.
• Copy, export, share, clean, and health-check extracted URLs.
• Save extractions into collections and revisit them later from history.

1. Install dependencies:

   pnpm install

2. Build the extension bundle:

   pnpm build

3. Load the built extension from dist/ in chrome://extensions.

• Run the focused unit tests:

  pnpm test

• Rebuild the extension bundle:

  pnpm build

• Region extraction for links, images, and contacts
• Full-page extraction
• Context-menu extraction from a section
• URL cleaning for common tracking parameters
• Link health checks with runtime host-permission requests
• Grouping, filtering, sorting, deduping, and keyboard navigation
• Saved collections, imports, comparisons, and history replay
• Plain text, CSV, JSON, Markdown, and HTML exports

• activeTab: inject the extraction flow into the current page
• scripting: run the content script and page notifications
• storage: persist collections, settings, and history
• contextMenus: add the section-extraction context menu
• optional_host_permissions: request site access only when the user runs link health checks