Lection

Search YouTube for videos by keyword, like "n8n automation tutorial" or "best budget laptops 2026". Returns up to 20 videos with title, channel, view count, upload date, duration and URL. Use it for content research, finding competitors and spotting popular topics. To list videos from one specific channel use youtube_channel_videos instead.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Search keywords, exactly as you would type them into YouTube.",
      "type": "string",
      "minLength": 2,
      "maxLength": 150
    },
    "maxRows": {
      "description": "How many rows to return (1-20, default 20). The free ChatGPT app is capped at 20.",
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "tool": {
      "type": "string"
    },
    "count": {
      "description": "Number of rows returned",
      "type": "number"
    },
    "rows": {
      "description": "Result rows",
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "fullToolUrl": {
      "description": "Lection page for running this at full scale with exports and schedules",
      "type": "string"
    },
    "error": {
      "type": "string"
    }
  },
  "required": [
    "tool",
    "count",
    "rows"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

List the latest videos on one YouTube channel, given its @handle or URL (for example "@OpenAI" or https://www.youtube.com/@OpenAI). Returns up to 20 recent uploads with title, upload date, view count, duration and URL. Use it to audit a creator or competitor channel. To search all of YouTube by keyword use youtube_search.

{
  "type": "object",
  "properties": {
    "channel": {
      "description": "Channel @handle (e.g. \"@OpenAI\") or channel URL.",
      "type": "string",
      "minLength": 2,
      "maxLength": 300
    },
    "maxRows": {
      "description": "How many rows to return (1-20, default 20). The free ChatGPT app is capped at 20.",
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "channel"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "tool": {
      "type": "string"
    },
    "count": {
      "description": "Number of rows returned",
      "type": "number"
    },
    "rows": {
      "description": "Result rows",
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "fullToolUrl": {
      "description": "Lection page for running this at full scale with exports and schedules",
      "type": "string"
    },
    "error": {
      "type": "string"
    }
  },
  "required": [
    "tool",
    "count",
    "rows"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Fetch top-level comments from one public YouTube video, given its URL. Returns up to 20 top comments with author, text, like count, reply count, date and the author's channel link. Use it for audience sentiment, feedback mining and finding engaged commenters. Needs a specific video URL; to find videos first use youtube_search.

{
  "type": "object",
  "properties": {
    "url": {
      "description": "Full YouTube video URL, e.g. https://www.youtube.com/watch?v=dQw4w9WgXcQ (youtu.be and /shorts/ links also work).",
      "type": "string",
      "minLength": 5,
      "maxLength": 300
    },
    "maxRows": {
      "description": "How many rows to return (1-20, default 20). The free ChatGPT app is capped at 20.",
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "tool": {
      "type": "string"
    },
    "count": {
      "description": "Number of rows returned",
      "type": "number"
    },
    "rows": {
      "description": "Result rows",
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    },
    "fullToolUrl": {
      "description": "Lection page for running this at full scale with exports and schedules",
      "type": "string"
    },
    "error": {
      "type": "string"
    }
  },
  "required": [
    "tool",
    "count",
    "rows"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Explain how to export data from Instagram (comments, followers, following, posts) or LinkedIn (connections) with Lection. These sites require login, so they run in the user's own browser through the Lection Chrome extension rather than inside ChatGPT. Call this whenever the user asks for Instagram or LinkedIn data; it returns the install link and the right tool page.

{
  "type": "object",
  "properties": {
    "platform": {
      "description": "Which site the user wants data from.",
      "type": "string",
      "enum": [
        "instagram",
        "linkedin",
        "other"
      ]
    }
  },
  "required": [
    "platform"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Show the linked user's Lection plan, how many schedules they can run, allowed delivery destinations and available cloud credits. Use before scheduling or when a plan limit is hit.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the user's most recent saved scrapes in Lection (title, page, row count, id). A saved scrape is the starting point for schedule_extraction and get_run_results.

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "How many recent saved scrapes to list (1-20).",
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch the rows of one of the user's saved scrapes or scheduled runs by id and show them as a table. Use list_my_saved_scrapes or list_my_runs first to find the id.

{
  "type": "object",
  "properties": {
    "id": {
      "description": "Id of a saved scrape (from list_my_saved_scrapes) or of a scheduled run (from list_my_runs).",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "kind": {
      "description": "Whether `id` is a saved scrape or a scheduled run.",
      "type": "string",
      "enum": [
        "saved_scrape",
        "scheduled_run"
      ]
    },
    "maxRows": {
      "description": "Rows to return (1-200).",
      "default": 50,
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "id",
    "kind"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the user's scheduled extractions: name, cadence, destination, next run and last status.

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Filter by schedule status.",
      "type": "string",
      "enum": [
        "active",
        "paused"
      ]
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List recent runs of the user's schedules with status, row counts and errors.

{
  "type": "object",
  "properties": {
    "scheduleId": {
      "description": "Only runs of this schedule.",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "status": {
      "type": "string",
      "enum": [
        "queued",
        "running",
        "succeeded",
        "failed",
        "cancelled",
        "timed_out"
      ]
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Create a recurring schedule (hourly, daily or weekly) that re-runs one of the user's saved scrapes and delivers each run to email, a Google Sheet or a webhook. This creates a recurring job in the user's Lection account and may use cloud credits: confirm the saved scrape, cadence and destination with the user before calling. Respects the user's plan limits and returns a clear message if one is reached.

{
  "type": "object",
  "properties": {
    "savedScrapeId": {
      "description": "Id of an existing saved scrape in the user's Lection account (from list_my_saved_scrapes). The schedule re-runs that scrape.",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "name": {
      "description": "Schedule name, at least 3 characters.",
      "type": "string",
      "minLength": 3,
      "maxLength": 80
    },
    "cadence": {
      "description": "How often to run.",
      "type": "string",
      "enum": [
        "hourly",
        "daily",
        "weekly"
      ]
    },
    "timeOfDay": {
      "description": "HH:MM (24h) in the given timezone, for daily/weekly. Default 09:00.",
      "type": "string",
      "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
    },
    "weekday": {
      "description": "0=Sunday .. 6=Saturday, for weekly. Default 1 (Monday).",
      "type": "integer",
      "minimum": 0,
      "maximum": 6
    },
    "timezone": {
      "description": "IANA timezone, e.g. \"America/Chicago\". Default UTC.",
      "type": "string",
      "maxLength": 64
    },
    "destination": {
      "description": "Where each run is delivered. google_sheet needs the user to have connected Google Sheets in Lection; webhook needs webhookUrl.",
      "default": "email",
      "type": "string",
      "enum": [
        "email",
        "google_sheet",
        "webhook"
      ]
    },
    "spreadsheetUrl": {
      "description": "Google Sheet URL (destination google_sheet).",
      "type": "string",
      "format": "uri"
    },
    "webhookUrl": {
      "description": "HTTPS webhook URL (destination webhook).",
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "savedScrapeId",
    "name",
    "cadence"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Pause one of the user's schedules so it stops running. The user can resume it from the Lection dashboard. Confirm with the user first.

{
  "type": "object",
  "properties": {
    "scheduleId": {
      "description": "Id of the schedule to pause (from list_my_schedules).",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  },
  "required": [
    "scheduleId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}