privacy
Privacy policy
Last updated
This policy covers the scoop.md Chrome extension, the shared library at api.scoop.md, and this website. They are run by [LEGAL ENTITY] ("we"). Questions go to privacy@scoop.md.
The short version
- The extension never reads the pages you visit. Opening it asks the library at
api.scoop.mdfor the site's llms.txt, with the page's origin and the first segment of its path only (for examplehttps://app.example.com/docs), never for a page on your computer or a private network. - To show "1" or "2" on its icon (the site has an llms.txt, and instructions for agents), it compares each tab's site with a list downloaded to your device and with what the library told it for sites you opened scoop.md on (kept on your device for 7 days); that check never leaves your device.
- Usage statistics are on by default: anonymous events about how you use the extension, including the hostname of the sites you open it on. The extension says so the first time you open it, with a button to turn them off; you can also turn them off in its settings ("Send usage statistics").
- No accounts, names or emails. Nothing about sites you don't open scoop.md on. No ads, no third-party trackers, and we don't sell data.
- IP addresses are used for rate limiting and to look up your country, and are not stored.
What the extension reads
When you open scoop.md, the extension reads the active tab's address. It doesn't read the page, other tabs or your browsing history. It writes the llms.txt prompt to your clipboard; it never reads your clipboard. A small background script reads the address of the tab you switch to, only to set the "1" or "2" on the icon from a list on your device; it handles installs and updates and sends queued usage statistics (once an hour at most, and only while they're on).
If the library doesn't answer, the extension looks for the site's llms.txt itself, directly from that site and without your cookies. That request goes to the documentation site, not to us. This is why the extension asks for access to all sites: it can't know in advance which site you'll open it on.
What stays on your device
- The prompt on your clipboard.
- Your settings, stored in Chrome's extension storage. Usage statistics on or off syncs with your Google account if you use Chrome sync; the theme stays on this device.
- A random install ID the extension creates on first run. It identifies an installation, not a person. The settings page shows it.
- The list behind the "1" and "2", and what the library answered for sites you opened scoop.md on (7 days).
- Usage events waiting to be sent (at most 500; the oldest are dropped).
What leaves your device
Opening scoop.md: the site's llms.txt
When you open scoop.md on a web page, the extension sends only the page's origin and the first segment of its path (on https://docs.stripe.com/webhooks/quickstart?lang=node, that's https://docs.stripe.com/webhooks) to api.scoop.md/v1/llms, which answers with the site's llms.txt (or one scoop.md prepared for it) as a short prompt to copy. Never for pages on your computer or a private network. If the library doesn't answer, the extension looks for the site's llms.txt itself, without your cookies.
The "1" and "2" on the icon
Every 6 hours the extension downloads the list of sites with an llms.txt (and which of them also have instructions for agents) from api.scoop.md/v1/sites/index (the request says nothing about you or your tabs). The site you're on is looked up in that list on your device, along with what the library answered for sites you opened scoop.md on in the last 7 days. Pages on your computer or a private network are never looked up.
Every request also carries what any web request does: your IP address and your browser's user agent, plus the extension's version.
Usage statistics
Unless you turn them off, the extension sends anonymous usage events to api.scoop.md/v1/events, in batches: when the popup closes, and from its background script. We use them to see who installs and keeps using scoop.md, which documentation sites it's used on, what works and what breaks. The first time you open the extension it shows a notice with a button to turn them off; until that notice has been shown, events carry no hostname.
| Event | What it records |
|---|---|
installupdatebrowser_update | When the extension is installed or updated, or Chrome updates: the old and new version. |
active_daily | Once a day while the browser runs: nothing beyond the common fields below. |
popup_openpopup_close | You opened the popup; when it closes, how long it was open. |
llms_copy | You copied a site's llms.txt prompt: the hostname, whether the llms.txt was the site's own or prepared by scoop.md, and whether it was copied on opening or with the button. |
copied_animation_shown | The "copied to your clipboard" animation played, and whether your system asks for reduced motion. |
badge_llms_shown | Once an hour at most: how many times the toolbar badge showed "1" (the site has an llms.txt) and "2" (an llms.txt and instructions for agents). Two numbers, no sites or pages. |
settings_changeoptions_open | You changed the theme or usage statistics, or opened the settings page. |
telemetry_opt_outtelemetry_opt_in | You switched usage statistics off or on. |
error | Something failed: where, an error code and a short message with URLs and hostnames removed. |
Versions before 0.6.0, which copied the page itself and could share it, also sent these (we still accept them from those versions):
| Event | What it records |
|---|---|
scoop_startscoop_result | A scoop of the page began and how it ended: the hostname (only its registrable domain for a signed-in page), the path of public docs pages, the outcome, the kinds and number of sources, the size, how long it took, and whether the shared library or the docs index had it. |
copyrebuild | The page package reached the clipboard, or was rebuilt from the page: the hostname, the path (public docs pages only) and the size. |
crawl_requestcrawl_wait | A crawl was requested for a docs site: the hostname and how it went. |
tab_switchsearchcopy_overviewcopy_search | Tabs switched, searches made (the query's length, never its text) and results or overviews copied, on indexed sites. |
share_resultvotereport | Whether a scoop was shared, and votes and reports on shared scoops. |
badge_verdict_shown | Once an hour at most: how many times the toolbar icon showed "developer docs" and "not developer docs". Two numbers, no sites. |
Every event also carries the time, a random ID for that popup session, your install ID, the extension version, the browser's name and version, the operating system and CPU architecture, the browser's interface language and your time zone.
- Sites: the hostname of the site you opened scoop.md on, never a path. Nothing at all about pages on your computer or a private network (
localhost, private IP addresses,.local,.internal,.corp,.onionand similar). - Never: page content, page titles, what you copy, cookies, your name, email or Google account, or anything about tabs you didn't open scoop.md on.
- Worked out on our server: your country, region and continent, and the name of your network provider, looked up by Cloudflare from your IP address as the request arrives; the browser family from the user agent; and, to spot abuse, a hash of your IP address made with a random key that is created each day and deleted after two days. Once a day's key is gone, nobody, including us, can tell which IP address a hash came from or link it to another day's. The hashes are deleted after 30 days and never archived. The IP address itself is never stored.
- Turning it off: switch off "Send usage statistics" in the extension's settings. The extension then sends one last event saying you switched it off, deletes any events still waiting, and sends nothing more (not even the daily ping) until you switch it back on. Its requests to the library are marked so they aren't recorded as library requests either (below).
- Uninstalling: Chrome opens
scoop.md/bye. While usage statistics are on, its address includes your install ID and version after a#, the part a browser never sends to a website's servers, and the page records the uninstall and, if you click one, your reason.
Library requests
For lookups to the library (including the extension's llms.txt lookup), the library records the route, the hostname, whether anything was found, how long it took, the X-Scoop-Client value and the country, with the time rounded to the hour. Not the IP address, region, network, browser or an install ID, and nothing at all for an extension with usage statistics off.
What the library keeps
- Shared scoops (from versions before 0.6.0; 0.6.0 shares nothing): the documentation text, source URLs, page address and title, related links, the time it was shared and the sharer's install ID. Scoops and their vote counts are public, on this website and through the API. Install IDs are never published.
- Votes: scoop ID, install ID, the vote and when it was cast. One per install; a new vote replaces the old one.
- Reports: as submitted, until they are resolved and for our records afterwards.
- Crawl requests: the page address you asked from, the site, a keyed hash of your install ID (requests from one install can be grouped, but the hash can't be turned back into the ID), what the request led to and when. Kept for 90 days, then deleted. The site's crawled documentation is kept like any other.
- Request logs: method, route, status, duration and extension version. No IP addresses, install IDs or content.
- Usage statistics and website page views: each event in our database for 180 days, then deleted. Daily counts (per day, event, hostname, country and version, with no install IDs) are kept. Every event (without the IP hash) is also kept in a compressed archive for later analysis, for 13 months.
IP addresses are used only to apply rate limits and look up the country, and are not stored. Scoops stay until they are taken down. When one is taken down, its content is deleted and a record that it existed is kept for audit.
We run on Cloudflare, which processes requests to this website and the library on our behalf.
This website
scoop.md sets no cookies and loads no third-party scripts. Fonts are served from this site. The library pages show only the public data described above.
Each page view sends a small event to api.scoop.md: the page's path, the referring site's hostname, any utm_source, utm_medium and utm_campaign, and clicks on the main buttons. Our server adds the country and the browser family, and counts visitors with a hash of your IP address and user agent made with that day's random key (deleted after two days), so a visitor can't be followed from one day to the next. If your browser sends Global Privacy Control or Do Not Track, no page views or clicks are recorded. The uninstall page is described underUsage statistics.
Your choices
- Turn sharing off in the extension's options. Scooping still works; nothing is uploaded and no crawl is requested. For a public page on a site whose docs are indexed, the page's address is still sent to look it up in the index.
- Turn usage statistics off in the extension's options. Scooping and sharing still work.
- Uninstalling the extension deletes its settings and install ID from your browser.
- To have the usage statistics linked to your install ID deleted, email team@ddamoah.comwith the install ID shown on the extension's settings page. We delete its events from our database, stop accepting new ones for it, and leave it out of every export of the archive until the archive copy is deleted (13 months after it was written). Daily counts don't contain install IDs and stay. For shared scoops, votes and reports, email privacy@scoop.md.
Takedowns
If a scoop contains something it shouldn't (your content, wrong or harmful material), use the report button in the extension or email privacy@scoop.md with the site and scoop. Publishers can also ask us to stop storing scoops for their site.
Children
scoop.md is a developer tool and isn't directed at children.
Changes
If we change what's collected, we'll update this page and its date before the change ships. Material changes will be noted in the extension's release notes.
Contact
[LEGAL ENTITY], privacy@scoop.md