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

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

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.

EventWhat it records
installupdatebrowser_updateWhen the extension is installed or updated, or Chrome updates: the old and new version.
active_dailyOnce a day while the browser runs: nothing beyond the common fields below.
popup_openpopup_closeYou opened the popup; when it closes, how long it was open.
llms_copyYou 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_shownThe "copied to your clipboard" animation played, and whether your system asks for reduced motion.
badge_llms_shownOnce 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_openYou changed the theme or usage statistics, or opened the settings page.
telemetry_opt_outtelemetry_opt_inYou switched usage statistics off or on.
errorSomething 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):

EventWhat it records
scoop_startscoop_resultA 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.
copyrebuildThe page package reached the clipboard, or was rebuilt from the page: the hostname, the path (public docs pages only) and the size.
crawl_requestcrawl_waitA crawl was requested for a docs site: the hostname and how it went.
tab_switchsearchcopy_overviewcopy_searchTabs switched, searches made (the query's length, never its text) and results or overviews copied, on indexed sites.
share_resultvotereportWhether a scoop was shared, and votes and reports on shared scoops.
badge_verdict_shownOnce 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.

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

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

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