GovTube
Search what U.S. officials said on camera, with timestamps and citations. Not a government site.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"govtube": {
"url": "https://api.govtube.us/mcp"
}
}
}Puntos de conexión remotos
https://api.govtube.us/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (7)
🟢govtube_search_instances(query, speaker, include_unreviewed, source, date_from, ...)
Find spoken instances of words or a phrase across official videos and White House transcripts. Returns one small page: counts for the whole result, then up to 5 videos (newest first, or most instances first with sort="most_instances"), each with up to 3 passages (quotes; overlapping instances merged), each passage listing its instances with citation id and share_url. `notes` and `more_passages` say what else there is: use `next_cursor` for more videos, govtube_list_video_instances for the rest of one video, and detail="full" for larger pages. White House transcripts have no timing (`timing_granularity` "document", null times, a `position` and a `document_url`).
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"description": "Words to find. Put an exact phrase in double quotes: \"no tax on tips\". Unquoted words must occur within 8 words of each other.",
"title": "Query",
"type": "string"
},
"speaker": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Bioguide ID of a member of Congress, e.g. 'C001053' (Rep. Tom Cole). Matches speakers a person has confirmed. Names matched only from the on-screen caption are left out (the result counts them in unreviewed_excluded) unless include_unreviewed is true. Omit to search everyone.",
"examples": [
"C001053"
],
"title": "Speaker"
},
"include_unreviewed": {
"default": false,
"description": "With speaker: also return moments where that person was named from the on-screen caption and nobody has reviewed the name yet. They are labelled 'matched from on-screen name, not reviewed'; say so when you quote them.",
"title": "Include Unreviewed",
"type": "boolean"
},
"source": {
"anyOf": [
{
"enum": [
"house_floor_clerk",
"senate_floor_and_committees",
"govinfo_dcpd",
"govinfo_crec",
"us_gov_youtube"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Only one source: house_floor_clerk (U.S. House floor), senate_floor_and_committees (U.S. Senate floor and committee hearings), govinfo_dcpd (White House transcripts, no video timing), govinfo_crec (Congressional Record, House and Senate speeches as printed, no video timing) or us_gov_youtube (official U.S. government YouTube channels; see source_caveats). A source can hold nothing yet: govtube_get_coverage lists what each one holds.",
"title": "Source"
},
"date_from": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Earliest event date, YYYY-MM-DD.",
"title": "Date From"
},
"date_to": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Latest event date, YYYY-MM-DD.",
"title": "Date To"
},
"detail": {
"default": "compact",
"description": "compact (default): small pages, passages only. full: the larger pages of the REST API (default 10 videos x 5), with every instance listed one by one as well as in passages.",
"enum": [
"compact",
"full"
],
"title": "Detail",
"type": "string"
},
"max_videos": {
"anyOf": [
{
"maximum": 25,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Videos per page, 1 to 25. Default 5, or 10 with detail=\"full\".",
"title": "Max Videos"
},
"max_instances_per_video": {
"anyOf": [
{
"maximum": 20,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Passages per video, 1 to 20 (with detail=\"full\", also instances). Default 3, or 5 with detail=\"full\".",
"title": "Max Instances Per Video"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "next_cursor from the previous page of the same search (same query and filters).",
"title": "Cursor"
},
"sort": {
"default": "newest",
"description": "newest (default): event date, newest first; on the same day, video sessions before official transcripts. most_instances: most instances first; check order_exact in the response.",
"enum": [
"newest",
"most_instances"
],
"title": "Sort",
"type": "string"
},
"playable_only": {
"default": false,
"description": "true: only results with playable video; transcript-only results (no video) are left out and counted in counts.transcript_only.",
"title": "Playable Only",
"type": "boolean"
}
},
"required": [
"query"
],
"title": "search_instancesArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"query": {
"type": "string"
},
"normalized_query": {
"type": "string"
},
"sort": {
"enum": [
"newest",
"most_instances"
],
"type": "string"
},
"order_exact": {
"type": "boolean"
},
"detail": {
"enum": [
"compact",
"full"
],
"type": "string"
},
"counts": {
"$ref": "#/$defs/Counts"
},
"videos": {
"items": {
"$ref": "#/$defs/McpVideoResult"
},
"type": "array"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"unreviewed_excluded": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"limits": {
"additionalProperties": {
"type": "integer"
},
"type": "object"
}
},
"required": [
"query",
"normalized_query",
"sort",
"order_exact",
"detail",
"counts",
"videos",
"next_cursor",
"notes",
"limits"
],
"$defs": {
"CountPart": {
"properties": {
"instances": {
"type": "integer"
},
"videos": {
"type": "integer"
},
"exact": {
"type": "boolean"
}
},
"required": [
"instances",
"videos",
"exact"
],
"type": "object"
},
"Counts": {
"properties": {
"instances": {
"type": "integer"
},
"videos": {
"type": "integer"
},
"exact": {
"type": "boolean"
},
"by_timing": {
"additionalProperties": {
"type": "integer"
},
"type": "object"
},
"playable": {
"$ref": "#/$defs/CountPart"
},
"transcript_only": {
"$ref": "#/$defs/CountPart"
}
},
"required": [
"instances",
"videos",
"exact",
"playable",
"transcript_only"
],
"type": "object"
},
"DocumentPosition": {
"properties": {
"paragraph": {
"minimum": 1,
"type": "integer"
},
"word": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"paragraph",
"word"
],
"type": "object"
},
"Excerpt": {
"properties": {
"text": {
"type": "string"
},
"match": {
"items": {
"$ref": "#/$defs/MatchSpan"
},
"type": "array"
},
"highlight": {
"items": {
"$ref": "#/$defs/MatchSpan"
},
"type": "array"
},
"start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"end_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"boundary": {
"enum": [
"sentence",
"clause",
"window"
],
"type": "string"
},
"truncated_before": {
"default": false,
"type": "boolean"
},
"truncated_after": {
"default": false,
"type": "boolean"
}
},
"required": [
"text",
"match",
"start_ms",
"end_ms",
"boundary"
],
"type": "object"
},
"MatchSpan": {
"properties": {
"start": {
"type": "integer"
},
"end": {
"type": "integer"
}
},
"required": [
"start",
"end"
],
"type": "object"
},
"McpInstance": {
"properties": {
"id": {
"type": "string"
},
"video_id": {
"type": "string"
},
"start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"end_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"play_from_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"timing_granularity": {
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"resolution_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"position": {
"anyOf": [
{
"$ref": "#/$defs/DocumentPosition"
},
{
"type": "null"
}
],
"default": null
},
"document_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"document_highlight_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"speaker": {
"$ref": "#/$defs/SpeakerInfo"
},
"excerpt": {
"$ref": "#/$defs/Excerpt"
},
"playable": {
"type": "boolean"
},
"low_confidence": {
"default": false,
"type": "boolean"
},
"caption_check": {
"default": "not_checked",
"enum": [
"agrees",
"differs",
"not_checked"
],
"type": "string"
},
"share_url": {
"type": "string"
}
},
"required": [
"id",
"video_id",
"start_ms",
"end_ms",
"play_from_ms",
"timing_granularity",
"resolution_ms",
"speaker",
"excerpt",
"playable",
"share_url"
],
"type": "object"
},
"McpPassage": {
"properties": {
"excerpt": {
"$ref": "#/$defs/Excerpt"
},
"start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"end_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"play_from_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"timing_granularity": {
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"resolution_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"position": {
"anyOf": [
{
"$ref": "#/$defs/DocumentPosition"
},
{
"type": "null"
}
],
"default": null
},
"document_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"document_highlight_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"instances": {
"items": {
"$ref": "#/$defs/McpPassageInstance"
},
"type": "array"
}
},
"required": [
"excerpt",
"start_ms",
"end_ms",
"play_from_ms",
"timing_granularity",
"resolution_ms",
"instances"
],
"type": "object"
},
"McpPassageInstance": {
"properties": {
"id": {
"type": "string"
},
"start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"end_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"play_from_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"timing_granularity": {
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"resolution_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"position": {
"anyOf": [
{
"$ref": "#/$defs/DocumentPosition"
},
{
"type": "null"
}
],
"default": null
},
"speaker": {
"$ref": "#/$defs/SpeakerInfo"
},
"low_confidence": {
"default": false,
"type": "boolean"
},
"caption_check": {
"default": "not_checked",
"enum": [
"agrees",
"differs",
"not_checked"
],
"type": "string"
},
"playable": {
"type": "boolean"
},
"share_url": {
"type": "string"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"id",
"start_ms",
"end_ms",
"play_from_ms",
"timing_granularity",
"resolution_ms",
"speaker",
"playable",
"share_url"
],
"type": "object"
},
"McpVideoResult": {
"properties": {
"video": {
"$ref": "#/$defs/VideoSummary"
},
"rights": {
"type": "string"
},
"instance_count": {
"type": "integer"
},
"passage_count": {
"type": "integer"
},
"more_passages": {
"type": "integer"
},
"passages": {
"items": {
"$ref": "#/$defs/McpPassage"
},
"type": "array"
},
"instances": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/McpInstance"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"video",
"rights",
"instance_count",
"passage_count",
"more_passages",
"passages"
],
"type": "object"
},
"PlaybackAsset": {
"properties": {
"kind": {
"enum": [
"youtube",
"hls",
"mp4"
],
"type": "string"
},
"ref": {
"type": "string"
},
"offset_ms": {
"default": 0,
"type": "integer"
},
"alignment_verified": {
"default": false,
"type": "boolean"
},
"made_for_kids": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"kind",
"ref"
],
"type": "object"
},
"SourceChannel": {
"properties": {
"channel_id": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"channel_id",
"name",
"url"
],
"type": "object"
},
"SpeakerInfo": {
"properties": {
"cluster": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"person_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"display_name": {
"type": "string"
},
"confirmed": {
"default": false,
"type": "boolean"
},
"match_status": {
"default": "unconfirmed",
"enum": [
"unconfirmed",
"matched_unreviewed",
"confirmed"
],
"type": "string"
},
"match_source": {
"items": {
"enum": [
"onscreen",
"congressional_record",
"reviewer"
],
"type": "string"
},
"type": "array"
}
},
"required": [
"cluster",
"display_name"
],
"type": "object"
},
"VideoLink": {
"properties": {
"video_id": {
"type": "string"
},
"video_rev": {
"minimum": 1,
"type": "integer"
},
"start_ms": {
"minimum": 0,
"type": "integer"
},
"end_ms": {
"minimum": 0,
"type": "integer"
},
"coverage": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"tier": {
"enum": [
"high",
"standard",
"bracketed"
],
"type": "string"
},
"method": {
"const": "text_alignment",
"default": "text_alignment",
"type": "string"
}
},
"required": [
"video_id",
"video_rev",
"start_ms",
"end_ms",
"coverage",
"tier"
],
"type": "object"
},
"VideoSummary": {
"properties": {
"video_id": {
"type": "string"
},
"title": {
"type": "string"
},
"event_date": {
"format": "date",
"type": "string"
},
"source_id": {
"type": "string"
},
"source_url": {
"type": "string"
},
"playback": {
"anyOf": [
{
"$ref": "#/$defs/PlaybackAsset"
},
{
"type": "null"
}
],
"default": null
},
"duration_ms": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"timing_granularity": {
"default": "word",
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"fidelity": {
"default": "verbatim",
"enum": [
"verbatim",
"clean",
"edited"
],
"type": "string"
},
"source_certainty": {
"default": "unverified",
"enum": [
"official_record",
"official_channel",
"unverified"
],
"type": "string"
},
"source_caveats": {
"items": {
"type": "string"
},
"type": "array"
},
"source_channel": {
"anyOf": [
{
"$ref": "#/$defs/SourceChannel"
},
{
"type": "null"
}
],
"default": null
},
"record_delivery": {
"anyOf": [
{
"enum": [
"not_spoken",
"may_include_not_spoken"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"video_link": {
"anyOf": [
{
"$ref": "#/$defs/VideoLink"
},
{
"type": "null"
}
],
"default": null
},
"video_delivery": {
"anyOf": [
{
"enum": [
"delivered",
"not_found"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"video_id",
"title",
"event_date",
"source_id",
"source_url"
],
"type": "object"
}
}
}🟢govtube_list_video_instances(video_id, query, offset, limit, speaker, ...)
Page through one video's matches by passage, in time order. A passage is a run of instances whose excerpts overlap, shown as one quote. `offset` and `limit` count passages; `next_offset` is null on the last page. `passage_count` and `instance_count` cover the whole video. With detail="full", `instances` also lists every instance of the page one by one.
Esquema de entrada
{
"type": "object",
"properties": {
"video_id": {
"description": "video_id from a search result.",
"title": "Video Id",
"type": "string"
},
"query": {
"description": "The same query as the search.",
"title": "Query",
"type": "string"
},
"offset": {
"default": 0,
"description": "Passages to skip; use next_offset from the previous page.",
"minimum": 0,
"title": "Offset",
"type": "integer"
},
"limit": {
"anyOf": [
{
"maximum": 100,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Passages per page, 1 to 100. Default 10, or 20 with detail=\"full\".",
"title": "Limit"
},
"speaker": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Bioguide ID of a member of Congress, e.g. 'C001053' (Rep. Tom Cole). Matches speakers a person has confirmed. Names matched only from the on-screen caption are left out (the result counts them in unreviewed_excluded) unless include_unreviewed is true. Omit to search everyone.",
"examples": [
"C001053"
],
"title": "Speaker"
},
"include_unreviewed": {
"default": false,
"description": "With speaker: also return moments where that person was named from the on-screen caption and nobody has reviewed the name yet. They are labelled 'matched from on-screen name, not reviewed'; say so when you quote them.",
"title": "Include Unreviewed",
"type": "boolean"
},
"detail": {
"default": "compact",
"description": "compact (default): small pages, passages only. full: the larger pages of the REST API (default 10 videos x 5), with every instance listed one by one as well as in passages.",
"enum": [
"compact",
"full"
],
"title": "Detail",
"type": "string"
}
},
"required": [
"video_id",
"query"
],
"title": "list_video_instancesArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"video": {
"$ref": "#/$defs/VideoSummary"
},
"rights": {
"type": "string"
},
"instance_count": {
"type": "integer"
},
"passage_count": {
"type": "integer"
},
"more_passages": {
"type": "integer"
},
"passages": {
"items": {
"$ref": "#/$defs/McpPassage"
},
"type": "array"
},
"instances": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/McpInstance"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
},
"offset": {
"type": "integer"
},
"next_offset": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"unreviewed_excluded": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"video",
"rights",
"instance_count",
"passage_count",
"more_passages",
"passages",
"offset",
"next_offset",
"notes"
],
"$defs": {
"DocumentPosition": {
"properties": {
"paragraph": {
"minimum": 1,
"type": "integer"
},
"word": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"paragraph",
"word"
],
"type": "object"
},
"Excerpt": {
"properties": {
"text": {
"type": "string"
},
"match": {
"items": {
"$ref": "#/$defs/MatchSpan"
},
"type": "array"
},
"highlight": {
"items": {
"$ref": "#/$defs/MatchSpan"
},
"type": "array"
},
"start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"end_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"boundary": {
"enum": [
"sentence",
"clause",
"window"
],
"type": "string"
},
"truncated_before": {
"default": false,
"type": "boolean"
},
"truncated_after": {
"default": false,
"type": "boolean"
}
},
"required": [
"text",
"match",
"start_ms",
"end_ms",
"boundary"
],
"type": "object"
},
"MatchSpan": {
"properties": {
"start": {
"type": "integer"
},
"end": {
"type": "integer"
}
},
"required": [
"start",
"end"
],
"type": "object"
},
"McpInstance": {
"properties": {
"id": {
"type": "string"
},
"video_id": {
"type": "string"
},
"start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"end_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"play_from_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"timing_granularity": {
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"resolution_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"position": {
"anyOf": [
{
"$ref": "#/$defs/DocumentPosition"
},
{
"type": "null"
}
],
"default": null
},
"document_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"document_highlight_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"speaker": {
"$ref": "#/$defs/SpeakerInfo"
},
"excerpt": {
"$ref": "#/$defs/Excerpt"
},
"playable": {
"type": "boolean"
},
"low_confidence": {
"default": false,
"type": "boolean"
},
"caption_check": {
"default": "not_checked",
"enum": [
"agrees",
"differs",
"not_checked"
],
"type": "string"
},
"share_url": {
"type": "string"
}
},
"required": [
"id",
"video_id",
"start_ms",
"end_ms",
"play_from_ms",
"timing_granularity",
"resolution_ms",
"speaker",
"excerpt",
"playable",
"share_url"
],
"type": "object"
},
"McpPassage": {
"properties": {
"excerpt": {
"$ref": "#/$defs/Excerpt"
},
"start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"end_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"play_from_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"timing_granularity": {
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"resolution_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"position": {
"anyOf": [
{
"$ref": "#/$defs/DocumentPosition"
},
{
"type": "null"
}
],
"default": null
},
"document_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"document_highlight_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"instances": {
"items": {
"$ref": "#/$defs/McpPassageInstance"
},
"type": "array"
}
},
"required": [
"excerpt",
"start_ms",
"end_ms",
"play_from_ms",
"timing_granularity",
"resolution_ms",
"instances"
],
"type": "object"
},
"McpPassageInstance": {
"properties": {
"id": {
"type": "string"
},
"start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"end_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"play_from_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"timing_granularity": {
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"resolution_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"position": {
"anyOf": [
{
"$ref": "#/$defs/DocumentPosition"
},
{
"type": "null"
}
],
"default": null
},
"speaker": {
"$ref": "#/$defs/SpeakerInfo"
},
"low_confidence": {
"default": false,
"type": "boolean"
},
"caption_check": {
"default": "not_checked",
"enum": [
"agrees",
"differs",
"not_checked"
],
"type": "string"
},
"playable": {
"type": "boolean"
},
"share_url": {
"type": "string"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"id",
"start_ms",
"end_ms",
"play_from_ms",
"timing_granularity",
"resolution_ms",
"speaker",
"playable",
"share_url"
],
"type": "object"
},
"PlaybackAsset": {
"properties": {
"kind": {
"enum": [
"youtube",
"hls",
"mp4"
],
"type": "string"
},
"ref": {
"type": "string"
},
"offset_ms": {
"default": 0,
"type": "integer"
},
"alignment_verified": {
"default": false,
"type": "boolean"
},
"made_for_kids": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"kind",
"ref"
],
"type": "object"
},
"SourceChannel": {
"properties": {
"channel_id": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"channel_id",
"name",
"url"
],
"type": "object"
},
"SpeakerInfo": {
"properties": {
"cluster": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"person_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"display_name": {
"type": "string"
},
"confirmed": {
"default": false,
"type": "boolean"
},
"match_status": {
"default": "unconfirmed",
"enum": [
"unconfirmed",
"matched_unreviewed",
"confirmed"
],
"type": "string"
},
"match_source": {
"items": {
"enum": [
"onscreen",
"congressional_record",
"reviewer"
],
"type": "string"
},
"type": "array"
}
},
"required": [
"cluster",
"display_name"
],
"type": "object"
},
"VideoLink": {
"properties": {
"video_id": {
"type": "string"
},
"video_rev": {
"minimum": 1,
"type": "integer"
},
"start_ms": {
"minimum": 0,
"type": "integer"
},
"end_ms": {
"minimum": 0,
"type": "integer"
},
"coverage": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"tier": {
"enum": [
"high",
"standard",
"bracketed"
],
"type": "string"
},
"method": {
"const": "text_alignment",
"default": "text_alignment",
"type": "string"
}
},
"required": [
"video_id",
"video_rev",
"start_ms",
"end_ms",
"coverage",
"tier"
],
"type": "object"
},
"VideoSummary": {
"properties": {
"video_id": {
"type": "string"
},
"title": {
"type": "string"
},
"event_date": {
"format": "date",
"type": "string"
},
"source_id": {
"type": "string"
},
"source_url": {
"type": "string"
},
"playback": {
"anyOf": [
{
"$ref": "#/$defs/PlaybackAsset"
},
{
"type": "null"
}
],
"default": null
},
"duration_ms": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"timing_granularity": {
"default": "word",
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"fidelity": {
"default": "verbatim",
"enum": [
"verbatim",
"clean",
"edited"
],
"type": "string"
},
"source_certainty": {
"default": "unverified",
"enum": [
"official_record",
"official_channel",
"unverified"
],
"type": "string"
},
"source_caveats": {
"items": {
"type": "string"
},
"type": "array"
},
"source_channel": {
"anyOf": [
{
"$ref": "#/$defs/SourceChannel"
},
{
"type": "null"
}
],
"default": null
},
"record_delivery": {
"anyOf": [
{
"enum": [
"not_spoken",
"may_include_not_spoken"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"video_link": {
"anyOf": [
{
"$ref": "#/$defs/VideoLink"
},
{
"type": "null"
}
],
"default": null
},
"video_delivery": {
"anyOf": [
{
"enum": [
"delivered",
"not_found"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"video_id",
"title",
"event_date",
"source_id",
"source_url"
],
"type": "object"
}
}
}🟢govtube_get_transcript_window(video_id, start_ms, end_ms)
Return speaker turns overlapping [start_ms, end_ms] with their text, for checking context. A turn with cluster null and speaker "No speaker label" holds words no voice was found for. The words are as heard; don't attribute them to a neighbouring speaker. Not available for official transcripts without timing (timing_granularity "document"): read those at the result's document_url, or resolve the citation for the surrounding turns.
Esquema de entrada
{
"type": "object",
"properties": {
"video_id": {
"description": "video_id from a search result.",
"title": "Video Id",
"type": "string"
},
"start_ms": {
"description": "Start, in milliseconds from the start of the video, e.g. an instance's start_ms minus 30000.",
"minimum": 0,
"title": "Start Ms",
"type": "integer"
},
"end_ms": {
"description": "End, in milliseconds; at most 5 minutes after start_ms.",
"minimum": 1,
"title": "End Ms",
"type": "integer"
}
},
"required": [
"video_id",
"start_ms",
"end_ms"
],
"title": "get_transcript_windowArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"result": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
}
},
"required": [
"result"
]
}🟢govtube_get_video(video_id)
Metadata, speakers, playback asset and the rights and use restrictions of the video's source.
Esquema de entrada
{
"type": "object",
"properties": {
"video_id": {
"description": "video_id from a search result.",
"title": "Video Id",
"type": "string"
}
},
"required": [
"video_id"
],
"title": "get_videoArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"video": {
"$ref": "#/$defs/VideoMeta"
},
"rights": {
"$ref": "#/$defs/RightsSummary"
}
},
"required": [
"video",
"rights"
],
"$defs": {
"PlaybackAsset": {
"properties": {
"kind": {
"enum": [
"youtube",
"hls",
"mp4"
],
"type": "string"
},
"ref": {
"type": "string"
},
"offset_ms": {
"default": 0,
"type": "integer"
},
"alignment_verified": {
"default": false,
"type": "boolean"
},
"made_for_kids": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"kind",
"ref"
],
"type": "object"
},
"RightsSummary": {
"properties": {
"source_id": {
"type": "string"
},
"source_name": {
"type": "string"
},
"kicker": {
"type": "string"
},
"short_name": {
"type": "string"
},
"rights_short": {
"type": "string"
},
"rights_basis": {
"type": "string"
},
"use_restrictions": {
"items": {
"type": "string"
},
"type": "array"
},
"confidence": {
"type": "string"
},
"policy_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"source_id",
"source_name",
"kicker",
"short_name",
"rights_short",
"rights_basis",
"use_restrictions",
"confidence",
"policy_url"
],
"type": "object"
},
"SourceChannel": {
"properties": {
"channel_id": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"channel_id",
"name",
"url"
],
"type": "object"
},
"SpeakerInfo": {
"properties": {
"cluster": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"person_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"display_name": {
"type": "string"
},
"confirmed": {
"default": false,
"type": "boolean"
},
"match_status": {
"default": "unconfirmed",
"enum": [
"unconfirmed",
"matched_unreviewed",
"confirmed"
],
"type": "string"
},
"match_source": {
"items": {
"enum": [
"onscreen",
"congressional_record",
"reviewer"
],
"type": "string"
},
"type": "array"
}
},
"required": [
"cluster",
"display_name"
],
"type": "object"
},
"TranscriptSource": {
"properties": {
"producer": {
"type": "string"
},
"origin_url": {
"type": "string"
},
"retrieved_at": {
"type": "string"
},
"sha256": {
"type": "string"
},
"registry_id": {
"type": "string"
},
"granularity": {
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"fidelity": {
"enum": [
"verbatim",
"clean",
"edited"
],
"type": "string"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"producer",
"origin_url",
"retrieved_at",
"sha256",
"registry_id",
"granularity",
"fidelity"
],
"type": "object"
},
"VideoLink": {
"properties": {
"video_id": {
"type": "string"
},
"video_rev": {
"minimum": 1,
"type": "integer"
},
"start_ms": {
"minimum": 0,
"type": "integer"
},
"end_ms": {
"minimum": 0,
"type": "integer"
},
"coverage": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"tier": {
"enum": [
"high",
"standard",
"bracketed"
],
"type": "string"
},
"method": {
"const": "text_alignment",
"default": "text_alignment",
"type": "string"
}
},
"required": [
"video_id",
"video_rev",
"start_ms",
"end_ms",
"coverage",
"tier"
],
"type": "object"
},
"VideoMeta": {
"properties": {
"video_id": {
"type": "string"
},
"title": {
"type": "string"
},
"full_title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"full_title_truncated": {
"default": false,
"type": "boolean"
},
"event_date": {
"format": "date",
"type": "string"
},
"source_id": {
"type": "string"
},
"source_url": {
"type": "string"
},
"transcript_rev": {
"default": 1,
"type": "integer"
},
"speakers": {
"additionalProperties": {
"$ref": "#/$defs/SpeakerInfo"
},
"type": "object"
},
"playback": {
"anyOf": [
{
"$ref": "#/$defs/PlaybackAsset"
},
{
"type": "null"
}
],
"default": null
},
"asr_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"duration_ms": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"word_cloud": {
"anyOf": [
{
"$ref": "#/$defs/WordCloud"
},
{
"type": "null"
}
],
"default": null
},
"timing_granularity": {
"default": "word",
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"resolution_ms": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"fidelity": {
"default": "verbatim",
"enum": [
"verbatim",
"clean",
"edited"
],
"type": "string"
},
"transcript_source": {
"anyOf": [
{
"$ref": "#/$defs/TranscriptSource"
},
{
"type": "null"
}
],
"default": null
},
"subjects": {
"items": {
"type": "string"
},
"type": "array"
},
"source_certainty": {
"default": "unverified",
"enum": [
"official_record",
"official_channel",
"unverified"
],
"type": "string"
},
"source_caveats": {
"items": {
"type": "string"
},
"type": "array"
},
"source_channel": {
"anyOf": [
{
"$ref": "#/$defs/SourceChannel"
},
{
"type": "null"
}
],
"default": null
},
"record_delivery": {
"anyOf": [
{
"enum": [
"not_spoken",
"may_include_not_spoken"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"part_of_page": {
"default": false,
"type": "boolean"
},
"video_link": {
"anyOf": [
{
"$ref": "#/$defs/VideoLink"
},
{
"type": "null"
}
],
"default": null
},
"video_delivery": {
"anyOf": [
{
"enum": [
"delivered",
"not_found"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"video_id",
"title",
"event_date",
"source_id",
"source_url"
],
"type": "object"
},
"WordCloud": {
"properties": {
"terms": {
"items": {
"$ref": "#/$defs/WordCloudTerm"
},
"type": "array"
},
"top_words": {
"items": {
"$ref": "#/$defs/WordCount"
},
"type": "array"
},
"generated_at": {
"type": "string"
},
"words": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"generated_at",
"words"
],
"type": "object"
},
"WordCloudTerm": {
"properties": {
"text": {
"type": "string"
},
"weight": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"count": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"text",
"weight",
"count"
],
"type": "object"
},
"WordCount": {
"properties": {
"text": {
"type": "string"
},
"count": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"text",
"count"
],
"type": "object"
}
}
}🟢govtube_resolve_citation(citation_id)
Check that a cited instance still says the quoted words after corrections, and return its context. The result has a share_url to link. gd2./gd1. ids cite words in an official transcript: the result has positions instead of times, citation_text to paste, document_highlight_url, and `certifies` saying what is (and is not) certified.
Esquema de entrada
{
"type": "object",
"properties": {
"citation_id": {
"description": "An instance id (gt2.... or gd2...., or an older gt1.... or gd1....).",
"title": "Citation Id",
"type": "string"
}
},
"required": [
"citation_id"
],
"title": "resolve_citationArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"note": {
"type": "string"
},
"video_id": {
"type": "string"
},
"timing_granularity": {
"default": "word",
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"original_start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"current_start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"original_position": {
"anyOf": [
{
"$ref": "#/$defs/DocumentPosition"
},
{
"type": "null"
}
],
"default": null
},
"current_position": {
"anyOf": [
{
"$ref": "#/$defs/DocumentPosition"
},
{
"type": "null"
}
],
"default": null
},
"document_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"citation_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"certifies": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"quoted_text": {
"type": "string"
},
"signed": {
"default": false,
"type": "boolean"
},
"canonical_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"transcript_context": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"cited_rev": {
"type": "integer"
},
"current_rev": {
"type": "integer"
},
"corrected_at": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"replacement": {
"anyOf": [
{
"$ref": "#/$defs/CitationReplacement"
},
{
"type": "null"
}
],
"default": null
},
"replacement_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"low_confidence": {
"default": false,
"type": "boolean"
},
"withheld": {
"default": false,
"type": "boolean"
},
"caption_check": {
"default": "not_checked",
"enum": [
"agrees",
"differs",
"not_checked"
],
"type": "string"
},
"words_checked": {
"default": false,
"type": "boolean"
},
"source_certainty": {
"default": "unverified",
"enum": [
"official_record",
"official_channel",
"unverified"
],
"type": "string"
},
"source_caveats": {
"items": {
"type": "string"
},
"type": "array"
},
"share_url": {
"type": "string"
},
"document_highlight_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"status",
"note",
"video_id",
"original_start_ms",
"current_start_ms",
"quoted_text",
"cited_rev",
"current_rev",
"share_url"
],
"$defs": {
"CitationReplacement": {
"properties": {
"video_id": {
"type": "string"
},
"start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"end_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"play_from_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"position": {
"anyOf": [
{
"$ref": "#/$defs/DocumentPosition"
},
{
"type": "null"
}
],
"default": null
},
"text": {
"type": "string"
}
},
"required": [
"video_id",
"start_ms",
"end_ms",
"play_from_ms",
"text"
],
"type": "object"
},
"DocumentPosition": {
"properties": {
"paragraph": {
"minimum": 1,
"type": "integer"
},
"word": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"paragraph",
"word"
],
"type": "object"
}
}
}🟢govtube_get_coverage
Totals for the whole index, video and official transcripts counted apart: video sessions, hours and words transcribed; official transcripts (text, no timing); each source; date ranges, last update, items awaiting review and known gaps. Cite this with any count. For the list of sessions use govtube_list_sessions.
Esquema de entrada
{
"type": "object",
"properties": {},
"title": "get_coverageArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"videos": {
"type": "integer"
},
"first_event_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
]
},
"last_event_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
]
},
"last_ingested_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"awaiting_review": {
"type": "integer"
},
"known_gaps": {
"items": {
"type": "string"
},
"type": "array"
},
"total_hours": {
"type": "number"
},
"total_words": {
"type": "integer"
},
"video": {
"$ref": "#/$defs/VideoCoverage"
},
"documents": {
"$ref": "#/$defs/DocumentCoverage"
},
"collections": {
"items": {
"$ref": "#/$defs/CoverageCollection"
},
"type": "array"
},
"by_timing": {
"additionalProperties": {
"type": "integer"
},
"type": "object"
},
"sources": {
"items": {
"$ref": "#/$defs/SourceCoverage"
},
"type": "array"
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"revised": {
"default": 0,
"type": "integer"
},
"corrections": {
"items": {
"$ref": "#/$defs/CorrectionEntry"
},
"type": "array"
}
},
"required": [
"videos",
"first_event_date",
"last_event_date",
"last_ingested_at",
"awaiting_review",
"known_gaps",
"total_hours",
"total_words",
"video",
"documents",
"collections",
"by_timing",
"sources",
"notes"
],
"$defs": {
"CorrectionEntry": {
"properties": {
"id": {
"type": "integer"
},
"at": {
"type": "string"
},
"action": {
"enum": [
"hidden",
"restored"
],
"type": "string"
},
"video_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"event_date": {
"format": "date",
"type": "string"
},
"source_id": {
"type": "string"
},
"source_name": {
"type": "string"
},
"rev": {
"type": "integer"
},
"reason": {
"type": "string"
}
},
"required": [
"id",
"at",
"action",
"video_id",
"title",
"event_date",
"source_id",
"source_name",
"rev",
"reason"
],
"type": "object"
},
"CoverageCollection": {
"properties": {
"key": {
"type": "string"
},
"kind": {
"enum": [
"video",
"document"
],
"type": "string"
},
"source_id": {
"type": "string"
},
"label": {
"type": "string"
},
"unit": {
"type": "string"
},
"units": {
"type": "string"
},
"short_name": {
"type": "string"
},
"rights_short": {
"type": "string"
},
"items": {
"minimum": 0,
"type": "integer"
},
"first_event_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
]
},
"last_event_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
]
},
"hours": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"words": {
"minimum": 0,
"type": "integer"
},
"speaker_labels": {
"minimum": 0,
"type": "integer"
},
"speakers_confirmed": {
"minimum": 0,
"type": "integer"
},
"awaiting_review": {
"minimum": 0,
"type": "integer"
},
"days": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/CoverageDay"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"key",
"kind",
"source_id",
"label",
"unit",
"units",
"short_name",
"rights_short",
"items",
"first_event_date",
"last_event_date",
"hours",
"words",
"speaker_labels",
"speakers_confirmed",
"awaiting_review"
],
"type": "object"
},
"CoverageDay": {
"properties": {
"event_date": {
"format": "date",
"type": "string"
},
"items": {
"minimum": 0,
"type": "integer"
},
"words": {
"minimum": 0,
"type": "integer"
},
"parts": {
"additionalProperties": {
"type": "integer"
},
"type": "object"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"event_date",
"items",
"words"
],
"type": "object"
},
"DocumentCoverage": {
"properties": {
"count": {
"default": 0,
"minimum": 0,
"type": "integer"
},
"words": {
"default": 0,
"minimum": 0,
"type": "integer"
},
"first_event_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"last_event_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"type": "object"
},
"SourceCoverage": {
"properties": {
"source_id": {
"type": "string"
},
"source_name": {
"type": "string"
},
"videos": {
"type": "integer"
},
"first_event_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
]
},
"last_event_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
]
},
"hours": {
"type": "number"
},
"words": {
"type": "integer"
},
"rights": {
"type": "string"
}
},
"required": [
"source_id",
"source_name",
"videos",
"first_event_date",
"last_event_date",
"hours",
"words",
"rights"
],
"type": "object"
},
"VideoCoverage": {
"properties": {
"sessions": {
"default": 0,
"minimum": 0,
"type": "integer"
},
"hours": {
"default": 0,
"type": "number"
},
"words": {
"default": 0,
"minimum": 0,
"type": "integer"
},
"first_event_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"last_event_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"speaker_labels": {
"default": 0,
"minimum": 0,
"type": "integer"
},
"speakers_confirmed": {
"default": 0,
"minimum": 0,
"type": "integer"
},
"awaiting_review": {
"default": 0,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
}
}
}🟢govtube_list_sessions(source, date_from, date_to, limit, cursor, ...)
Every indexed item, one page at a time: video sessions and official transcripts (White House transcripts, Congressional Record speeches, one item per speech). Newest first; on the same day, video sessions before official transcripts. Each has title, date, source, length, words, whether it plays, and how many speakers are confirmed. `total` matches govtube_get_coverage's counts for the same source.
Esquema de entrada
{
"type": "object",
"properties": {
"source": {
"anyOf": [
{
"enum": [
"house_floor_clerk",
"senate_floor_and_committees",
"govinfo_dcpd",
"govinfo_crec",
"us_gov_youtube"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Only one source: house_floor_clerk (U.S. House floor), senate_floor_and_committees (U.S. Senate floor and committee hearings), govinfo_dcpd (White House transcripts, no video timing), govinfo_crec (Congressional Record, House and Senate speeches as printed, no video timing) or us_gov_youtube (official U.S. government YouTube channels; see source_caveats). A source can hold nothing yet: govtube_get_coverage lists what each one holds.",
"title": "Source"
},
"date_from": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Earliest event date, YYYY-MM-DD.",
"title": "Date From"
},
"date_to": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Latest event date, YYYY-MM-DD.",
"title": "Date To"
},
"limit": {
"default": 25,
"description": "Sessions per page, 1 to 100.",
"maximum": 100,
"minimum": 1,
"title": "Limit",
"type": "integer"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "next_cursor from the previous page (same filters).",
"title": "Cursor"
},
"kind": {
"anyOf": [
{
"enum": [
"video",
"document"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Only one kind: \"video\" (video sessions, timed transcripts) or \"document\" (official transcripts without video timing: White House transcripts, Congressional Record speeches). Omit for both.",
"title": "Kind"
}
},
"title": "list_sessionsArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"total": {
"type": "integer"
},
"sessions": {
"items": {
"$ref": "#/$defs/McpSession"
},
"type": "array"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"total",
"sessions",
"next_cursor"
],
"$defs": {
"McpSession": {
"properties": {
"video_id": {
"type": "string"
},
"title": {
"type": "string"
},
"event_date": {
"format": "date",
"type": "string"
},
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"duration_measured": {
"type": "boolean"
},
"timing_granularity": {
"default": "word",
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"fidelity": {
"default": "verbatim",
"enum": [
"verbatim",
"clean",
"edited"
],
"type": "string"
},
"words": {
"type": "integer"
},
"playable": {
"type": "boolean"
},
"playback_kind": {
"anyOf": [
{
"enum": [
"youtube",
"hls",
"mp4"
],
"type": "string"
},
{
"type": "null"
}
]
},
"speaker_labels": {
"type": "integer"
},
"speakers_confirmed": {
"type": "integer"
},
"transcript_rev": {
"type": "integer"
},
"collection": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"source_id": {
"type": "string"
}
},
"required": [
"video_id",
"title",
"event_date",
"duration_ms",
"duration_measured",
"words",
"playable",
"playback_kind",
"speaker_labels",
"speakers_confirmed",
"transcript_rev",
"source_id"
],
"type": "object"
}
}
}Comunidad
Evidencia