# Chrome Extension

**Citedy Clipper** - One-click content capture from Twitter and any webpage, instantly transformed into SEO-optimized articles.

---

## What is Citedy Clipper?

Citedy Clipper is a Chrome extension that eliminates friction from content discovery to publishing. With overlay buttons on tweets, smart selection bubbles for any text, and URL paste functionality, you can convert any web content into a full SEO article in 3-5 minutes.

## Key Features

### Twitter-First Overlay Button

- **One-click capture** directly from X/Twitter posts
- Auto-extracts tweet text, URL, and author
- No manual selection or copy-paste needed
- Visual confirmation with pulse animation

### Smart Selection Bubble

- **Highlight any text** on any webpage
- Floating bubble appears instantly
- Click to send selected content to Citedy
- Works on news sites, blogs, documentation, anywhere

### URL Paste Capture

- Paste any webpage URL into the extension
- Automatic text extraction and preprocessing
- 2-credit extraction cost for comprehensive processing
- Perfect for articles, research papers, documentation

### Queue Mode Processing

- Submit **multiple clips in succession**
- Automatic sequential processing
- Shows "Processing: X · Queued: Y" counter
- Prevents credit double-charging

### Full Solo Writer Control

Access identical article generation settings within the extension:

- **Article size**: mini / standard / full / pillar
- **SEO modes**: auto, E-E-A-T, NLP-semantic, Rank Math, Yoast, hybrid
- **Enhancement options**: illustrations, humanization, voice-over
- **Competition Intelligence** with sub-options
- **Estimated credits** shown before submission

---

## How It Works

### Capture from Twitter

1. See overlay icon on every tweet
2. Click → content auto-extracted
3. Popup opens with preview
4. Adjust settings if needed
5. Submit → article generated in 3-5 minutes
6. OS notification when ready

### Capture Selected Text

1. Highlight text on any page
2. Click "Send to Citedy" bubble
3. Popup opens with selection
4. Submit for article generation

### Capture from URL

1. Open extension popup
2. Paste URL in input field
3. Content extracted automatically
4. Review and submit

---

## Generation Pipeline

The extension uses the **same powerful pipeline** as the main Citedy platform:

```
Extract → Analyze → Transform → Illustrations → Humanize → Save → Voiceover
```

Each step:

- Automatic retries for 502/503/504 errors (up to 3 attempts)
- Request ID logging for troubleshooting
- Progress tracking via popup
- Sequential queue processing

---

## Authentication

**No additional login required.**

The extension auto-detects your Citedy session from browser cookies:

- Opens `/login` in new tab if not authenticated
- Extracts Supabase token from cookies
- All requests include proper authorization
- Secure session management

---

## Keyboard Shortcut

**Quick capture without mouse:**

- Mac: `Cmd + Shift + S`
- Windows: `Ctrl + Shift + S`

Priority detection:

1. Selected text (if any)
2. Tweet on current page (if on X/Twitter)
3. URL of current page

---

## Notifications & Feedback

- **Overlay pulse** - Visual confirmation on click
- **Bubble state change** - "Sent" confirmation
- **Auto-open popup** - Shows after submission (if allowed)
- **OS notifications**:
  - "Submitted" - confirms task queued
  - "Success" - article ready with open link
- **Badge dot** - Indicates completed job waiting

---

## Credit Costs

| Operation        | Credits | Description                  |
| ---------------- | ------- | ---------------------------- |
| URL extraction   | 2       | Text extraction from webpage |
| Mini article     | ~12-17  | 800-1,200 words              |
| Standard article | ~25-45  | 1,500-2,500 words            |
| Full article     | ~40-60  | 3,000-5,000 words            |
| Pillar article   | ~60-85  | 5,000-8,000 words            |
| Illustrations    | +5-10   | AI-generated images          |
| Voice-over       | +3-8    | Audio narration              |
| Humanization     | +5-15   | AI detection bypass          |

---

## Technical Architecture

### Chrome Manifest V3

- Built for Chrome's new extension standard
- Long-term Chrome Web Store compatibility
- No remote code execution
- Minimal permissions required

### Components

- **Content Script** - Overlay buttons, selection bubble, toast feedback
- **Service Worker** - Queue management, API calls, notifications
- **Popup UI** - Settings, status, results, history
- **Storage** - Local chrome.storage for settings and queue

### Data Flow

```
Content Script → Background Service Worker → Citedy API
     ↑                    ↓
   Toast UI         Queue Management
```

---

## Privacy & Security

- **Active user action required** - No automatic content collection
- **Local storage only** - Settings and job states stored locally
- **No new backend endpoints** - Uses existing secure APIs only
- **Cookie-based auth** - Leverages existing Citedy session
- **Minimal permissions** - Only accesses active tab on user action

---

## Use Cases

### Content Marketers

- Capture viral tweets for blog content
- Convert industry news into articles
- Build content library from research

### SEO Professionals

- Instant content from competitor analysis
- Transform research into optimized articles
- Rapid content gap filling

### Social Media Managers

- Convert social content to blog assets
- Repurpose viral posts into long-form
- Build content calendar efficiently

### Agencies

- Batch content capture for clients
- Rapid turnaround on trending topics
- Streamlined research-to-publish workflow

---

## Competitive Advantages

| Competitor     | Their Approach            | Citedy Clipper Advantage         |
| -------------- | ------------------------- | -------------------------------- |
| Jasper/Copy.ai | Dashboard-only generation | One-click clip from anywhere     |
| Surfer/Outrank | SEO research only         | Capture + transform in context   |
| Notion Clipper | Save to database          | Transform to SEO article         |
| Evernote       | General web clipping      | Article generation + publishing  |
| Native Chrome  | No AI enrichment          | 17+ AI providers powering output |

---

## Getting Started

1. **Install from Chrome Web Store** - Search "Citedy Clipper"
2. **Sign in to Citedy** - Extension detects your session
3. **Browse to Twitter** - See overlay buttons on tweets
4. **Click to capture** - Submit for article generation
5. **Get notified** - Article ready in 3-5 minutes

---

## Related Resources

- [Solo Article Generation](/ai/features/solo-article.md) - Same pipeline, dashboard version
- [Blog Autopilot](/ai/features/blog-autopilot.md) - Automated publishing workflow
- [Voice-Over](/ai/features/voice-over.md) - Audio narration for articles