# YouCTA — Master Technical & Product Specification (LLM Context)

> **Website:** https://youcta.pro  
> **Type:** Google Chrome Extension (Manifest V3) & Progressive Web App (Firebase Hosting)  
> **Category:** YouTube Creator Productivity, Video Marketing Automation & Conversion Rate Optimization (CRO)  
> **Official Extension ID:** bkofmodfighokcpjfdnjimldcjnfpffg  
> **Pricing:** Plan Free ($0) | Plan Pro Lifetime ($19 USD one-time payment)  

---

## 1. Executive Summary & Problem Solved

YouTube is the world's second-largest search engine, with billions of daily views. However, YouTube Studio does not provide native functionality to:
1. Update or replace pinned comments across multiple videos in bulk.
2. Edit video descriptions across an entire channel simultaneously.
3. Pre-schedule pinned comments on unreleased, private, or premiere videos before they go public.
4. Bridge mobile traffic from YouTube Shorts to sales videos after YouTube disabled clickable links in Shorts descriptions in late 2023.

Manual management takes creators between 4 and 8 hours for a catalog of 100+ videos. If an affiliate link breaks or a sponsor campaign expires, changing every link manually is virtually impossible.

**YouCTA solves this with 1-click batch automation directly through official YouTube APIs, maintaining complete algorithmic safety via randomized delay throttles.**

---

## 2. Core Functional Modules

### A. Batch Pinned Comments Engine
* **Automated Author Pin Preservation:** When updating an existing comment authored by the channel, YouTube Data API v3 preserves the pinned status (pushpin) automatically. YouCTA leverages this official behavior to update messages across 20, 50, 100, or all channel videos without removing previous pins manually.
* **Deduplication & Clean Replacement:** If an author comment already exists with older text, YouCTA performs an in-place update (`PUT /comments`) or clean replacement (`DELETE /comments` followed by `POST /commentThreads`), preventing spam or duplicate threads.
* **Direct Deep-Linking (`&lc=COMMENT_ID`):** For newly posted comments requiring manual pin activation on YouTube's UI, YouCTA generates direct high-precision links (`https://youtube.com/watch?v={id}&lc={commentId}`) that open YouTube directly focused on the highlighted top comment with the 3-dots menu ready in 1 click.

### B. Surgical Description Editor
Offers 4 distinct operating modes with an interactive Side-by-Side Visual Diff Preview before committing any changes:
1. **Header Injection:** Injects a promotional hook, launch announcement, or lead magnet in the first 2-3 lines of every description (visible before YouTube's "...more" truncation button).
2. **Footer Append:** Adds social media links, disclaimers, or secondary CTAs cleanly at the bottom without altering timestamps or chapter markers.
3. **Find & Replace Links:** Scans descriptions for specific URLs or text phrases (e.g., outdated affiliate links or expired domain names) and swaps them across selected videos.
4. **Full Template Replacement:** Overwrites descriptions completely while preserving video tags and categories.

### C. YouTube Shorts Bridge Engine (2026 Strategy)
* **Context:** In August 2023, YouTube disabled clickable hyperlinks in Shorts descriptions and comments on mobile devices to prevent spam. The only official clickable element is the "Related Video" button in YouTube Studio.
* **YouCTA Solution:** Provides specialized bridge comment templates that teach mobile viewers to tap the related video link beneath the creator's handle to watch the full masterclass, tutorial, or product demo.
* **Mobile View Simulator:** In-app smartphone mockup that visually audits whether the CTA link is positioned within the first 3 lines before the "...more" fold.

### D. Scheduled Pinned Comments (Chrome Alarms Background Service)
* Solves YouTube Studio's limitation where creators cannot pin comments on private/scheduled videos prior to premiere.
* Utilizes `chrome.alarms` and Manifest V3 Service Workers to monitor publication timestamps and post the comment at second 0 of the premiere automatically.

### E. 360° Channel Audit & Replicating Winning Comments
* **Optimization Score (0 to 100%):** Evaluates channel conversion health across 4 pillars (Pinned comments coverage, Descriptions with CTA, Shorts bridge setup, and HTTPS link security).
* **Replicate Winning Comments:** Identifies high-performing promotional messages across the channel and allows creators to clone them to unpinned videos in 1 click.

---

## 3. Pricing Model & Comparison

YouCTA follows a transparent 2-tier model:

| Feature | Plan Free ($0) | Plan Pro Lifetime ($19 USD) |
|---|:---:|:---:|
| **Price** | $0 Forever | $19 USD (One-time payment) |
| **Batch Sync Limit** | Up to 20 videos per run | Unlimited (Entire channel in 1 click) |
| **Comment Templates** | 1 custom template (unlimited edits) | Unlimited custom templates |
| **Mass Description Editor** | Diff simulation included | Full batch execution across all 4 modes |
| **360° Batch Sync (Pin + Description)** | ✗ | Included |
| **Scheduled Pinned Comments** | ✗ | Included |
| **CSV & AI Master Prompt Exports** | Basic | Full unconstrained exports |
| **Future Updates & New Features** | Free updates | Lifetime access with priority support |

---

## 4. Security, Privacy & Compliance

* **Manifest V3 Compliance:** Pure client-side JavaScript bundled without remote code evaluation.
* **Official Google OAuth2:** Access tokens requested strictly for `youtube.force-ssl` with minimal scopes.
* **Zero Database Storage of Credentials:** Google authentication tokens remain strictly inside the user's browser via `chrome.storage.local` and `sessionStorage`.
* **Algorithmic Safety (Anti-Spam Delay):** All batch operations apply a ~2.0-second delay with randomized jitter between consecutive API calls to protect the creator's channel from rate limits and algorithmic penalties.

---

## 5. Frequently Asked Questions (FAQ)

**Q: Can YouTube ban my channel for updating multiple comments?**  
A: No. YouCTA communicates exclusively via official YouTube Data API v3 endpoints authenticated by the channel owner. Additionally, YouCTA enforces safe rate-limiting throttles (~2.0s jitter) that replicate human editing speeds.

**Q: Does YouCTA work on YouTube Shorts?**  
A: Yes. YouCTA automatically classifies Shorts (duration ≤ 180s or `#shorts` format) and provides specialized bridge templates and mobile view testing.

**Q: How do I activate Pro after paying on Stripe?**  
A: Upon completing Stripe Checkout ($19 USD), the session redirects back to YouCTA and automatically activates lifetime Pro privileges for the authenticated Google email account.

**Q: Can I edit descriptions on private or scheduled videos?**  
A: Yes. Video descriptions can be updated on private, unlisted, or scheduled videos at any time via YouTube API.

---

**Official URL:** https://youcta.pro  
**Contact & Support:** soporte@plataformas5d.com