🚀 Medium Stats Collector (Chrome Extension)

A powerful, privacy-friendly Chrome Extension that collects detailed Medium article statistics using Medium’s internal GraphQL APIs. Easily aggregate stats for views, reads, claps, followers gained, subscribers gained, presentations, and more — for all your Medium posts.

This extension works directly on your Medium Stats dashboard and can auto-scroll to capture all posts, no matter how many you have.

---

📸 Screenshots

---

✨ Features

• Collect stats for visible posts or automatically scroll through your entire Medium stats page.
• Fetches detailed metrics via Medium’s internal GraphQL endpoints:
  • Views
  • Reads
  • Presentations
  • Claps
  • Followers Gained
  • Subscribers Gained
  • CTR and other internal metrics
• Totals tab with an auto-rendered mini bar chart (pure <canvas>, no external libs).
• Articles tab with sortable table of per-post stats.
• CSV Export for offline analytics.
• Automatically saves last collected data in Chrome storage.
• Works on:
  • https://medium.com/me/stats
  • Publication stats pages
  • Individual post stats pages

---

🛠️ Installation (Developer Mode)

1. Clone this repository:

   git clone https://github.com/your-user/medium-stats-extension.git
   cd medium-stats-extension

2. Open Chrome and navigate to:

   chrome://extensions/

3. Enable Developer Mode (top right).

4. Click Load unpacked and select this project folder.

5. You should now see the extension in your toolbar.

---

📘 How To Use

1. Open Medium Stats

Go to:

https://medium.com/me/stats

Wait for the posts to load.

2. Open the Extension Popup

Click the extension icon → Medium Stats Collector.

3. Choose an action:

▶️ Collect Visible

Fetch stats only for the posts currently loaded on the screen. Useful if you manually scroll and want partial data.

▶️ Collect ALL (Auto Scroll)

Auto-scrolls to the bottom of your stats page and captures all posts automatically. Works even with hundreds of posts.

▶️ Load Last

Reloads previously collected results from Chrome storage.

▶️ Collect Visible

Outputs a CSV with all collected stats.

---

📂 Project Structure

medium-stats-extension/
│
├── manifest.json        # Chrome Extension MV3 config
├── popup.html           # Extension popup UI
├── popup.js             # UI logic
├── styles.css           # Popup styling
│
├── background.js        # Main GraphQL collector (MV3 service worker)
├── content.js           # Stats page scanner
├── contentScript.js     # Auto-scrolling collector (paginated)
│
└── README.md            # This file

---

🔧 Technical Overview

⚙️ Background Service Worker (background.js)

• Handles GraphQL batching (10 posts per request).
• Uses Medium’s internal postStatsTotalBundle + postResult to gather full metrics.
• Normalizes and aggregates stats.
• Stores results in chrome.storage.local.

🖥️ Popup Application

• Renders stats in two modes:
  • Totals (with a mini bar chart)
  • Articles table
• Triggers collection logic.
• Exports CSV.

🌐 Content Scripts

• Scans Medium stats pages for post anchors.
• Extracts article IDs, titles, URLs.
• Supports:
  • Direct scan of visible posts.
  • Full-page auto-scroll scraping.

---

📊 Data Collected

For each article:

Metric	Description
views	ViewersCount
reads	ReadersCount
presentations	Feed presentation count
claps	Clap count
followersGained	Follows gained from the article
subscribersGained	Email subscribers gained
CTR	feedClickThroughRate

Important

No personal tokens, passwords, or private content is collected.

---

⚠️ Troubleshooting

❗ “Open Medium stats page first”

Ensure you are on:

https://medium.com/me/stats

❗ "No posts found"

Possible reasons:

• Stats page still loading
• You're on a publication dashboard with unusual DOM
• Medium changed the HTML (rare)

Try:

• Manual scroll once
• Refresh page
• Click Collect ALL

❗ "Background error: Failed to fetch"

This is usually caused by:

• Internet interruption
• Medium API throttling
• Session expired → Log out/in to Medium

❗ Content script error: Could not establish connection. Receiving end does not exist.

Possible reasons:

• Medium SPA not correctly update the routes

Try:

• Reload the /me/stats* or /me/stats/* page and try again

❗ Auto-scroll stops too early

Try increasing scroll speed:

• Ensure browser is active (Chrome throttles background tabs)
• Move the tab to foreground

---

🔒 Privacy

• All data is processed locally in your browser.
• Stats are retrieved using your existing Medium session cookies.
• No analytics, tracking, or external logging.
• No data leaves your machine.

---

⚠️ Disclaimer

This extension uses Medium's internal GraphQL API, which is undocumented and may change at any time. If Medium updates their internal endpoints, the extension may require an update.

---

📝 License

MIT License — free to modify, distribute, and use.

---

💬 Feedback & Contributions

Pull requests and issues are welcome! If you have ideas, improvements, or encounter API changes, feel free to open an issue.