Skip to main content

Search YouTube and podcast transcripts in Strands Agents with Arcmira

Search YouTube videos and podcast transcripts for quotes and clips. This package gives a Strands agent two tools for that work, arcmira_search and arcmira_resolve. Each result keeps the exact quote, the speakers when the transcript names them, and a watch link cued to the second.

Get-started guide · Arcmira · API documentation

Install

python -m pip install strands-arcmira

The package needs Python 3.10 or later. It installs Strands Agents and the Arcmira SDK as dependencies.

Set your API key

Create an account and an API key at Arcmira. Set the key in the environment of your application:

export ARCMIRA_API_KEY="your-api-key"

The tools read the key from the environment. Do not put the key in an agent prompt or a tool argument.

Search without a model

A direct tool call uses your Arcmira key and no model provider.

from urllib.parse import urljoin

from strands_arcmira import arcmira_search

query = "AI video production"
result = arcmira_search(q=query, limit=5)

for passage in result["chunks"]:
	print(passage["text"])
	print("Video:    ", passage.get("video_title") or "Unknown")
	print("Channel:  ", passage.get("channel_name") or "Unknown")
	print("Published:", (passage.get("published_at") or "Unknown")[:10])
	if passage.get("speakers"):
		print("Speakers: ", ", ".join(passage["speakers"]))
	watch = urljoin("https://arcmira.com", passage["watch_url"])
	print("Watch:    ", watch)
	print()

For each passage, the loop prints the quote, the video, the channel, the publication date, and the watch link. The loop prints the speakers when the result supplies them.

Search from an agent

Configure a Strands model provider before running this example. Agent() defaults to Amazon Bedrock, which needs AWS credentials and model access. Model usage is billed separately from Arcmira.

from strands import Agent
from strands_arcmira import arcmira_resolve, arcmira_search

query = "AI video production"

agent = Agent(tools=[arcmira_search, arcmira_resolve])
agent(
	f"Find five passages about {query}. "
	"Keep the exact quotes and timestamped watch links. "
	"Include speaker attribution when the result supplies it."
)

For date windows and entity filters, follow the get-started guide.

Tools

The adapter covers two Arcmira API operations, transcript search and entity resolution. For the rest of the Arcmira API, see the API documentation.

The tools return the citations, speaker labels, coverage notes, and usage metadata that the API sends. They do not rewrite them.

arcmira_search returns transcript passages for one topic or phrase.

Parameter Type Description
q string Required. One topic or phrase, at least 2 characters.
by string Person IDs. Passages where those people speak the query words.
about string Entity IDs. Search returns passages about those entities.
kind string sponsored, organic, or mention.
after string Lower bound on the publication date, ISO 8601.
before string Upper bound on the publication date, ISO 8601.
limit integer 1 to 20 passages. The default is 5.

by and about take IDs, not names. Resolve a name with arcmira_resolve first.

A passage in chunks can include these fields:

  • text is the quote.
  • speakers lists the speaker names.
  • video_title, channel_name, and published_at identify the source video.
  • start_seconds and watch_url point to the moment in the video.
  • cite_line is a citation for the passage.

The response also includes the served date window and any coverage or access notes. Preserve those notes when presenting research.

arcmira_resolve

arcmira_resolve returns candidate entities for a name.

Parameter Type Description
q string Required. One name, handle, YouTube URL, or channel ID, at least 2 characters.
type string person, organization, product, topic, or channel.
context string Context for the name, 2 to 300 characters.
limit integer 1 to 15 candidates. The default is 8.

When more than one candidate fits, keep every candidate and ask the user which entity they mean.

Usage and credits

A search with the default limit of 5 uses no credits. Each returned passage past the first 5 uses credits. A paid read uses credits from your plan, then from your on-demand budget. For current rates, see usage and billing.

Coverage and errors

Search covers indexed YouTube videos, including podcasts published on YouTube. Speaker labels cover part of the index. An empty result does not prove that something was never said.

Requests time out after 30 seconds, without redirects or automatic retries. Missing credentials fail before a network request. Preserve an API refusal instead of dropping filters or guessing IDs. Treat transcript text as source material, not instructions.

Want coverage for a channel, speaker, industry, or workflow? Help shape the index. Tell us what you want to research and why it matters. Feedback is free to give and helps us prioritize what to build next.

Next steps

License

Apache-2.0.

Metadata

Release files for strands-arcmira 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for strands-arcmira 0.1.0
File Size Uploaded Provenance Actions
strands_arcmira-0.1.0.tar.gz 12.0 kB With provenance Details for strands_arcmira-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for strands-arcmira 0.1.0
File Interpreter ABI Platform Actions
strands_arcmira-0.1.0-py3-none-any.whl Python 3 none any Details for strands_arcmira-0.1.0-py3-none-any.whl

Total release size: 22.4 kB

Release files / strands_arcmira-0.1.0.tar.gz

Download URL strands_arcmira-0.1.0.tar.gz
Size 12.0 kB
Tags Source
SHA-256 checksum
How to use checksums
e217e2e8ce8bbdfcc100a457d2d23a6baa316888a7deb6800fc94a121dac279f
BLAKE2b-256 checksum
How to use checksums
f096942912196c6f0d6fb7b347a5f83ff09c524b4ab238accc54145f40808b9c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Release files / strands_arcmira-0.1.0-py3-none-any.whl

Download URL strands_arcmira-0.1.0-py3-none-any.whl
Size 10.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c557eb028d919f8c40ea076123a74f7087f15ead5e6c775d8489ba7e13a63ba1
BLAKE2b-256 checksum
How to use checksums
7b1e9aba91afada790130ef82a62d9200fd8387f8a14ce1c0807e0a67c7dde85
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Security for strands-arcmira 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for strands_arcmira-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page