thoughtleaders-cli 0.7.6__tar.gz → 0.7.7__tar.gz

{thoughtleaders_cli-0.7.6 → thoughtleaders_cli-0.7.7}/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "tl-cli",
-  "version": "0.7.6",
+  "version": "0.7.7",
   "description": "ThoughtLeaders CLI — query sponsorship deals, channels, brands, uploads, and intelligence from the terminal",
   "author": {
     "name": "ThoughtLeaders",

{thoughtleaders_cli-0.7.6 → thoughtleaders_cli-0.7.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: thoughtleaders-cli
-Version: 0.7.6
+Version: 0.7.7
 Summary: ThoughtLeaders CLI — query sponsorship data, channels, brands, and intelligence
 Project-URL: Homepage, https://thoughtleaders.io
 Project-URL: Repository, https://github.com/ThoughtLeaders-io/thoughtleaders-cli
@@ -163,6 +163,7 @@ tl recommender tags cooking                      # Search tag names by substring
 tl recommender top-channels "Cooking" msn:yes --limit 50   # Top channels for a tag
 tl recommender top-profiles "Cooking" mbn:yes --limit 30   # Top brand profiles (one brand → potentially multiple profiles)
 tl recommender top-brands "Cooking" --limit 30             # Top brands (deduped from profiles)
+tl recommender channels-with-tag "Cooking"                 # ALL channel IDs loaded on a tag (--min defaults to 0.00001; paged; 1 credit/result)
 tl recommender inspect-channel 12345             # Per-tag breakdown of a channel's vector
 tl recommender inspect-brand Nike                # Per-tag breakdown of a brand's ideal profile
 tl recommender channels-for-profile 842          # Channels closest to a specific brand profile
@@ -277,8 +278,11 @@ Each agent discovers the skill automatically and uses it when you ask about spon
 The plugin ships several focused skills (installed by all the `tl setup *` commands):
 
 - **`tl`** — the data-analyst skill. Defaults to raw database queries via `tl db pg|fb|es` for anything non-trivial; uses the structured `tl <resource> show` / `find` / `similar` commands for single-record lookups and similarity / ID-resolution special cases. Comes with full schema references for Postgres, Elasticsearch, and Firebolt under `references/`.
-- **`tl-report-builder`** — builds TL reports (channels / brands / sponsorships / videos) from natural-language requests. Produces an in-chat preview by default; saves a real campaign when the user is explicit ("save", "create the report").
+- **`tl-keyword-research`** — broadens and ranks content-search keywords by Elasticsearch document count before a `tl db es` content search, so finding videos or channels by topic isn't bottlenecked on hand-guessed terms.
+- **`tl-save-report`** — persists the result set from an in-chat exploration session as a saved TL report ("save this as a report", "turn this into a campaign").
+- **`tl-report-builder`** — builds a brand-new TL report config from scratch (channels / brands / sponsorships / videos) through a guided multi-phase flow. Manual-invocation-only: reach it via `/tl-report-builder` or by naming it explicitly — natural-language report requests route to `tl`, `tl-save-report`, or `tl-import` instead.
 - **`tl-import`** / **`bulk-import`** — superuser-only; bulk-add or exclude lists of channels, brands, videos, or sponsorships against a report.
+- **`tl-channel-authenticity`** — vets a YouTube channel for non-organic views and bot/spam comments before booking (or after delivering) a sponsorship.
 - **`tl-views-guarantee`** — sizes a multi-video sponsorship buy for a channel, returning the video bundle size, views guarantee, and likelihood to hit.
 - **`tl-top-partnerships`** — brand-user performance report. Ranks a brand's sold sponsorships by live eCPM vs the sold-date projection, aggregates per channel, and delivers a two-tab Google Sheet ("By Deal" / "By Channel") via `gws`. Uses only public CLI commands (`tl whoami`, `tl sponsorships list`).
 

{thoughtleaders_cli-0.7.6 → thoughtleaders_cli-0.7.7}/README.md

@@ -135,6 +135,7 @@ tl recommender tags cooking                      # Search tag names by substring
 tl recommender top-channels "Cooking" msn:yes --limit 50   # Top channels for a tag
 tl recommender top-profiles "Cooking" mbn:yes --limit 30   # Top brand profiles (one brand → potentially multiple profiles)
 tl recommender top-brands "Cooking" --limit 30             # Top brands (deduped from profiles)
+tl recommender channels-with-tag "Cooking"                 # ALL channel IDs loaded on a tag (--min defaults to 0.00001; paged; 1 credit/result)
 tl recommender inspect-channel 12345             # Per-tag breakdown of a channel's vector
 tl recommender inspect-brand Nike                # Per-tag breakdown of a brand's ideal profile
 tl recommender channels-for-profile 842          # Channels closest to a specific brand profile
@@ -249,8 +250,11 @@ Each agent discovers the skill automatically and uses it when you ask about spon
 The plugin ships several focused skills (installed by all the `tl setup *` commands):
 
 - **`tl`** — the data-analyst skill. Defaults to raw database queries via `tl db pg|fb|es` for anything non-trivial; uses the structured `tl <resource> show` / `find` / `similar` commands for single-record lookups and similarity / ID-resolution special cases. Comes with full schema references for Postgres, Elasticsearch, and Firebolt under `references/`.
-- **`tl-report-builder`** — builds TL reports (channels / brands / sponsorships / videos) from natural-language requests. Produces an in-chat preview by default; saves a real campaign when the user is explicit ("save", "create the report").
+- **`tl-keyword-research`** — broadens and ranks content-search keywords by Elasticsearch document count before a `tl db es` content search, so finding videos or channels by topic isn't bottlenecked on hand-guessed terms.
+- **`tl-save-report`** — persists the result set from an in-chat exploration session as a saved TL report ("save this as a report", "turn this into a campaign").
+- **`tl-report-builder`** — builds a brand-new TL report config from scratch (channels / brands / sponsorships / videos) through a guided multi-phase flow. Manual-invocation-only: reach it via `/tl-report-builder` or by naming it explicitly — natural-language report requests route to `tl`, `tl-save-report`, or `tl-import` instead.
 - **`tl-import`** / **`bulk-import`** — superuser-only; bulk-add or exclude lists of channels, brands, videos, or sponsorships against a report.
+- **`tl-channel-authenticity`** — vets a YouTube channel for non-organic views and bot/spam comments before booking (or after delivering) a sponsorship.
 - **`tl-views-guarantee`** — sizes a multi-video sponsorship buy for a channel, returning the video bundle size, views guarantee, and likelihood to hit.
 - **`tl-top-partnerships`** — brand-user performance report. Ranks a brand's sold sponsorships by live eCPM vs the sold-date projection, aggregates per channel, and delivers a two-tab Google Sheet ("By Deal" / "By Channel") via `gws`. Uses only public CLI commands (`tl whoami`, `tl sponsorships list`).
 

{thoughtleaders_cli-0.7.6 → thoughtleaders_cli-0.7.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "thoughtleaders-cli"
-version = "0.7.6"
+version = "0.7.7"
 description = "ThoughtLeaders CLI — query sponsorship data, channels, brands, and intelligence"
 readme = "README.md"
 license = "MIT"

{thoughtleaders_cli-0.7.6 → thoughtleaders_cli-0.7.7}/skills/tl/SKILL.md

@@ -204,6 +204,7 @@ tl recommender tags [query]            # List similarity tag names — categorie
 tl recommender top-channels "<tag>"    # Top channels loaded on a similarity tag (Intelligence)
 tl recommender top-profiles "<tag>"    # Top brand profiles loaded on a similarity tag
 tl recommender top-brands "<tag>"      # Top brands (deduped from profiles) loaded on a similarity tag
+tl recommender channels-with-tag "<tag>" [--min <v>] # ALL channel IDs scoring >= v on a tag (--min default 0.00001 drops zero-loading channels; paged, enumerates the full set; 1 credit/result; Intelligence)
 tl recommender inspect-channel <ref>   # Show a channel's similarity-profile breakdown (Intelligence)
 tl recommender inspect-brand <ref>     # Show a brand profile's ideal similarity-profile breakdown (Intelligence)
 tl recommender channels-for-profile <id> # Find channels closest to a brand profile's ideal profile (Intelligence)

{thoughtleaders_cli-0.7.6 → thoughtleaders_cli-0.7.7}/src/tl_cli/__init__.py

@@ -1,3 +1,3 @@
 """ThoughtLeaders CLI — query sponsorship data, channels, brands, and intelligence."""
 
-__version__ = "0.7.6"
+__version__ = "0.7.7"

{thoughtleaders_cli-0.7.6 → thoughtleaders_cli-0.7.7}/src/tl_cli/auth/commands.py

@@ -187,9 +187,7 @@ def logout_cmd() -> None:
         # the interactive login established. Point the user at Auth0's logout
         # URL so the next `tl auth login` doesn't silently SSO straight back in.
         logout_url = f"https://{get_config().auth0_domain}/logout"
-        console.print(
-            f"To end your Auth0 browser session, visit: [cyan]{logout_url}[/cyan]"
-        )
+        console.print(f"To end your Auth0 browser session, visit: [cyan]{logout_url}[/cyan]")
     clear_tokens()
     console.print("[green]Logged out successfully.[/green]")
 

{thoughtleaders_cli-0.7.6 → thoughtleaders_cli-0.7.7}/src/tl_cli/auth/login.py

@@ -129,7 +129,7 @@ def login_device_code() -> StoredTokens:
     console.print()
     console.print(f"[bold]And enter the code:[/bold]  [cyan bold]{user_code}[/cyan bold]")
     console.print()
-    console.print(f"[dim]The code expires in {expires_in // 60} minutes.[/dim]")
+    console.print(f"[dim]The code expires in {expires_in // 60} minutes. After you have logged in successfully, please wait until the system is notified.[/dim]")
 
     # Poll for token
     deadline = time.time() + expires_in

{thoughtleaders_cli-0.7.6 → thoughtleaders_cli-0.7.7}/src/tl_cli/commands/recommender.py

@@ -210,6 +210,54 @@ def top_brands_cmd(
     _do_top("brands", tag, args or [], fmt, limit, TOP_BRAND_COLUMNS, f"Top brands: {tag}")
 
 
+@app.command("channels-with-tag")
+def channels_with_tag_cmd(
+    tag: str = typer.Argument(..., help='Similarity tag name (e.g. "Cooking", "Age 18-24"). Run `tl recommender tags` to discover valid names.'),
+    min_value: float = typer.Option(0.00001, "--min", help="Inclusive minimum tag value; only channels scoring at or above this are returned. Defaults to 0.00001, which excludes channels with no loading on the tag."),
+    json_output: bool = typer.Option(False, "--json", help="JSON output"),
+    csv_output: bool = typer.Option(False, "--csv", help="CSV output"),
+    md_output: bool = typer.Option(False, "--md", help="Markdown output"),
+    toon_output: bool = typer.Option(False, "--toon", help="TOON output (token-efficient for LLMs)"),
+    limit: int = typer.Option(100, "--limit", "-l", help="Max results per page (1-1000)"),
+    offset: int = typer.Option(0, "--offset", help="Pagination offset"),
+) -> None:
+    """Every channel whose value for a similarity tag is at or above a threshold.
+
+    Unlike `top-channels` (which ranks the strongest few), this walks the
+    *entire* match set in pages of up to 1000 — including sets larger than
+    the search index's 10k window — so you can enumerate every channel above
+    a cutoff. Returns channel IDs only; expand them with `tl channels show`
+    or `tl recommender inspect-channel`.
+
+    `--min` defaults to 0.00001 — just above zero — so a bare call returns
+    every channel with any loading on the tag and drops the zero-fill rest.
+    Raise it for a stricter cutoff.
+
+    Costs 1 credit per channel ID returned. Intelligence plan required.
+
+    Examples:
+        tl recommender channels-with-tag "Cooking"
+        tl recommender channels-with-tag "Age 18-24" --min 0.3 --limit 1000
+        tl recommender channels-with-tag "Cooking" --min 0.5 --offset 1000 --json
+    """
+    fmt = detect_format(json_output, csv_output, md_output, toon_output)
+    tag = _strip_quotes(tag)
+    params = {"tag": tag, "min": str(min_value), "limit": str(limit), "offset": str(offset)}
+    client = get_client()
+    try:
+        data = client.get("/recommender/channels-with-tag", params=params)
+        output(
+            data,
+            fmt,
+            columns=["channel_id"],
+            title=f"Channels with {tag} >= {min_value}",
+        )
+    except ApiError as e:
+        handle_api_error(e)
+    finally:
+        client.close()
+
+
 @app.command("inspect-channel")
 def inspect_channel_cmd(
     channel_ref: str = typer.Argument(..., help="Channel ID (numeric) or name (partial match, must be unique)"),