Chrome Extension v2

What the Chrome Extension does

The Aidelly Chrome Extension brings Aidelly tools into your browser with four powerful modules:

1. Approvals Command Center — approve/reject posts across all client workspaces from your toolbar
2. Competitor Clipper — save competitor posts as inspiration or track them
3. Browse-to-Post — turn any webpage or YouTube video into a multi-platform post with AI repurposing
4. Short Links — create tracked short links on any page

All modules use API-key authentication (no account sharing, no sign-in loop).

Step 1 — Install the extension

1. Open Chrome and go to the Chrome Web Store
2. Search for "Aidelly"
3. Click Add to Chrome
4. Confirm the installation
5. The Aidelly icon appears in your toolbar (top-right)

Alternatively, if you have a local build:

1. Go to chrome://extensions
2. Enable Developer mode (top-right toggle)
3. Click Load unpacked and select the chrome-extension directory
4. The extension loads and a local version appears in your toolbar

Step 2 — Sign in with your API key

1. Click the Aidelly icon in your toolbar
2. Go to the Settings tab
3. Paste your Aidelly API key (get it from Account Settings → API Keys)
4. The extension validates the key and saves it securely
5. Select your workspace (if you manage multiple)
6. You're signed in!

Note: Your API key stays in your browser, never sent to third parties. It's cleared if you uninstall the extension.

Module A — Approvals Command Center

Review and approve posts across all your client workspaces, right from your browser.

Using Approvals

1. Click the Aidelly icon → Approvals tab
2. See a count badge on the icon showing pending approvals
3. View workspace-grouped approval cards:
   • Batch approvals (content awaiting team review)
   • Team post approvals (posts from team members)
4. Click any card to see the post preview, caption, and platforms
5. Click Approve or Reject (+ optional reason)
6. The approval is recorded; list updates automatically

Badge notifications:

• Badge shows pending approval count
• Refreshes every 5 minutes
• Opt-in notifications: browser will notify you when approvals arrive (requires browser permission)

Module B — Competitor Clipper

Save and track competitive content without leaving the page.

Saving competitors

1. Click the Aidelly icon on any website
2. Choose Track as competitor (if it's a competitor domain)
3. Or choose Save as inspiration (any social post)
4. Content is saved to your Competitor Spy workspace

Note: The extension checks for duplicates before saving (avoids creating multiple entries for the same account).

Module I — Browse-to-Post

Turn webpage content into Aidelly posts with one click.

Creating a post from a page

1. Click the Aidelly icon on any webpage, YouTube video, or selection

2. Click Create post from the dropdown

3. The extension shows:

   • Selected content (text, image, or video frame)
   • Per-platform repurposing (Twitter, LinkedIn, Instagram, TikTok, etc.)
   • Draft editor (inline edit before scheduling)
   • Brand voice applied (uses your workspace's brand profile)

4. Options:

   • Schedule — pick a date/time
   • Publish now — goes live immediately (scheduled for now+30 seconds)
   • Save to Ideas — save as a draft without publishing

5. Credit cost shows per platform

6. Click Confirm → post created!

Behind the scenes:

• Repurposing job runs in the extension's service worker
• Even if you close the popup, the job keeps running
• A notification fires when done
• You can reopen the popup to check progress

Module H — Short Links

Create tracked short links with UTM parameters on any page.

Creating a short link

1. On any website, click the Aidelly icon → Short Links tab
2. The page URL is pre-filled
3. (Optional) Add UTM parameters:
   • Campaign, source, medium, etc.
4. Click Create
5. A short link appears — Copy it
6. Aidelly tracks clicks on that link in your analytics

Link reuse:

• If you've created a link for this URL before, the extension shows it (no duplicate)
• Choose to reuse it or create a new one

API key scopes and security

Your API key must have the scopes needed for each module:

If you paste an API key missing a scope, you'll see a clear "Permission denied" message naming the missing scope.

Create a new API key with the right scopes from Account Settings → API Keys.

How the extension stays signed in

• API key stored in extension-private storage (isolated from websites)
• Workspace preference saved locally
• No Aidelly account needed (API key auth only)
• Revoke the key from Account Settings anytime to sign out

Popup vs Service Worker

• Popup: Settings, workspace picker, approvals review, link creation (closes when you navigate away)
• Service Worker: Runs in the background, polls for approvals, completes repurposing jobs
• Session persistence: Repurposing jobs keep running even if popup closes; notification fires on completion

Common questions

Q: What if my API key is revoked?
A: The extension shows a 401 error. Get a new API key from Account Settings → API Keys and paste it into Settings.

Q: Do I need an Aidelly account to use the extension?
A: No. Your API key is your auth. You can use the extension without creating a password or logging into app.aidelly.ai.

Q: Is my API key encrypted in the extension?
A: Your key is stored in the browser's secure extension storage (similar to how password managers work). It's not sent anywhere except to Aidelly API endpoints.

Q: Can multiple extensions be installed?
A: We only support the official Chrome Web Store version. Local/dev versions may conflict.

Q: What if I get a "Rate limit" message?
A: You've hit the API rate limit. Wait a few minutes and try again. Approvals polling is capped to prevent this.

Q: Can I use the extension on incognito mode?
A: Not by default (extension storage is disabled). Enable it manually in chrome://extensions → Aidelly → allow in incognito.

Q: Does the extension work on other Chromium browsers (Edge, Brave, Opera)?
A: Likely yes (Chromium-compatible), but support is for Chrome only. Load unpacked builds work on Edge.

What to do next

• Account Settings — create an API key
• Team Approvals — manage approval workflow
• Competitor Spy — view tracked competitors
• Create Post — schedule and publish posts
• Link Shortener — view and manage all short links