Chrome Extension

What this is for

The Specky Chrome extension closes the gap between seeing something useful in a browser and getting it into the Product Graph. It is for the review quote, competitor page, job posting, support thread, or research note that has no native integration.

The extension is a working Manifest V3 build. The current distribution path is Chrome's Load unpacked developer-mode install; the Chrome Web Store listing is not represented as live until it is published.

Before you start

• Chrome or another Chromium browser such as Edge, Brave, Arc, or Vivaldi.
• A local checkout containing the chrome-extension/ directory.
• A workspace API key created in Settings → Developer.

Install it

1. Open chrome://extensions in your browser.
2. Enable Developer mode.
3. Click Load unpacked.
4. Select the repository's chrome-extension/ directory.
5. Pin Specky from the browser's extensions menu.
6. Open the extension, paste the workspace API key, and click Connect.

The popup verifies the key against your workspace before showing the workspace name. The key is stored in chrome.storage.local, not in a public page or source file.

Capture something

1. Highlight a quote on any webpage and right-click it.
2. Choose Add to Specky or one of the typed capture actions.
3. Review the detected source hint and the selected text.
4. Choose Competitive Intel, Customer Feedback, Market Research, or Hiring Intel.
5. Click Add to Product Graph.

You can also open the popup and paste text directly. The captured node keeps the selected content, page URL, page title, signal type, timestamp, and captured_via=chrome_extension marker. The source remains available for citations and later search.

What leaves the browser

Only an explicit capture: the text or page/link you selected, the page URL when available, the page title, and the signal type. The extension does not passively read every page and does not claim to capture anything you did not send.

Local development

Open the extension's Options page and change API endpoint to http://localhost:3000. Generate a key from the local Specky workspace and reconnect. This is useful when changing the extension or testing the capture route without touching production.

If capture fails

• Invalid or revoked key: create a new key in Settings → Developer and reconnect.
• Wrong workspace: check the workspace name shown after connection.
• No capture button: reload the page after installing or updating the extension.
• Local server error: check the Options endpoint and make sure the local server is running.
• Empty result: select at least one character of text; the inline selection capture requires a meaningful selection.