arcmira
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseArcmira
Arcmira
Arcmira indexes YouTube and podcast transcripts and keeps a catalog of who is mentioned on which show, who sponsors whom, and who recommends what on air. The arcmira MCP server exposes four tools. returns the client reference: every method with its arguments and return fields, worked programs, quirks and error codes. runs a JavaScript program against the client and returns what the program returns; Premium transcripts included. runs the same client plus the monitor writes. tells Arcmira what went wrong. The arcmira CLI has commands with the same names; , and are its reference.
arcmira_describearcmira_execute_readarcmiraarcmira_execute_writearcmira_feedbackarcmira <command> --helparcmira schema <command>arcmira examplesArcmira 为 YouTube 和播客的转录文本建立索引,并维护一份目录,记录哪些节目提及了谁、谁赞助了谁,以及谁在节目中推荐了什么。arcmira MCP server 暴露四个工具。 返回客户端参考文档:所有方法及其参数和返回字段、可用示例程序、特殊行为和错误代码。 针对 client 运行 JavaScript 程序,并返回程序的返回值;其中包含 Premium transcripts。 在同一 client 的基础上运行 monitor 写入操作。 用于告诉 Arcmira 哪里出了问题。arcmira CLI 提供了同名命令;、 和 是其参考入口。
arcmira_describearcmira_execute_readarcmiraarcmira_execute_writearcmira_feedbackarcmira <command> --helparcmira schema <command>arcmira examplesWhen to use
何时使用
Use this skill when the user asks:
- what a show, channel, or episode said about a topic, or for a transcript;
- whether a person, company, or product was mentioned, how often, and where;
- who sponsors a show, or which shows a brand sponsors;
- who recommends a product on air, sponsored or organic;
- whether talk about something is accelerating or fading;
- to be kept posted on a company, person or topic;
- how to use the arcmira MCP server or the arcmira CLI.
Use Arcmira for the indexed transcript research the user requested. Cite returned passages and keep evidence from other sources distinct. An empty result means this query returned no matches.
当用户提出以下请求时,使用此 skill:
- 某个节目、频道或单集如何谈论某个主题,或请求其转录文本;
- 是否提及某个人、公司或产品、提及频率以及提及位置;
- 谁赞助了某个节目,或某个品牌赞助了哪些节目;
- 谁在节目中推荐了某个产品,包括付费赞助或自然推荐;
- 关于某事的讨论是否正在升温或降温;
- 持续获知某家公司、某个人或某个主题的最新动态;
- 如何使用 arcmira MCP server 或 arcmira CLI。
对于用户请求的已建立索引的转录文本研究,使用 Arcmira。引用返回的段落,并将来自其他来源的证据区分开来。空结果表示此次查询没有匹配项。
Task skills
任务 skills
When the ask matches one of these, load that skill and follow its worked program:
- : Sponsor and ad-read research on podcasts and YouTube: who sponsors a show, or which shows a brand sponsors, how often, since when.
sponsor-research - : Watches a company or topic on podcasts and YouTube: what was said lately (shows, counts, momentum, quotes), then an Arcmira monitor to keep following it.
company-watch - : Finds exact spoken quotes and clip-ready moments on podcasts and YouTube: verbatim words, speaker, date, a timestamped link, clip start and end.
find-quotes - : Researches a person across podcasts and YouTube for interview or meeting prep: where they appeared, their own words, who discusses them.
person-research - : Compares two podcasts or YouTube shows side by side: size, latest episode, what each talks about, what both cover, and shared sponsors.
compare-shows
Anything else (one video's transcript, a topic across shows, who recommends a product on air) follows the procedure below.
当请求与以下 skill 匹配时,加载该 skill 并遵循其中的示例程序:
- :播客和 YouTube 上的赞助与广告口播研究:谁赞助了某个节目,或某个品牌赞助了哪些节目、频率如何、从何时开始。
sponsor-research - :监控播客和 YouTube 上的某家公司或主题:最近说了什么(节目、次数、热度、引用),然后创建 Arcmira monitor 以持续跟踪。
company-watch - :在播客和 YouTube 中查找准确的口述引用和可用于剪辑的时刻:逐字内容、说话者、日期、带时间戳的链接、剪辑开始和结束位置。
find-quotes - :跨播客和 YouTube 研究某个人,为访谈或会面做准备:他们出现在哪里、自己的原话、谁讨论过他们。
person-research - :并排比较两个播客或 YouTube 节目:规模、最新单集、各自讨论的内容、共同话题和共同赞助商。
compare-shows
其他任何请求(单个视频的转录文本、跨节目的主题、谁在节目中推荐产品等)均遵循以下流程。
Procedure
流程
- Call once before your first program. It is current on every call;
arcmira_describenarrows it to one method.arcmira_describe({ topic }) - Resolve every name in the question first, as the ID rule below says. Filters take ids only.
- Before asserting a mention, read its description or passage and say which sense of the name it is (Mercury the bank, not the element).
- Write one program per question. Resolve, check, and run every query the question needs inside that one program.
arcmira_execute_read - Return only the fields the answer needs, not whole responses.
- Search as_of is the newest publication date among the returned passages, not the date the whole index was updated. For channel freshness, call arcmira.status({ channelId }) and report channel.search_indexed_through for transcript search. A result date or an empty query does not establish missing recent episodes. Build date windows from and
arcmira.today(). When the user names no window, use the last 90 days, and narrow it when a name returns more than the answer needs.arcmira.daysAgo(n) - Link each name in the answer to the field the result carries. Do not build arcmira.com URLs by hand.
page - Premium: returns the lines. When the video is not transcribed yet, that read starts a transcription. Still pending:
arcmira.transcript(video, { quality: "premium" })says about how long; read again once it has passed.eta_seconds - USAGE. Metered reads use credits from the account's plan, then the on-demand budget set in the dashboard. Arcmira enforces that budget, and no tool takes a spending amount. A search uses 4 credits per passage it returns past the first 5. A Premium read that starts a transcription reports charge { unit, amount, from: included | on_demand | mixed }; arcmira.quote(video) returns that price beforehand (a price, not a spoken quote) and uses no credits. A read the plan or budget blocks throws ArcmiraError with code paid_plan_required, quota_exceeded, spend_limit_exceeded, member_limit, fair_use_cap or on_demand_paused, a message naming the limit, its figures in limit when reported, and unlock { tier, url } when a plan or setting change lifts it. An account admin changes member_limit, fair_use_cap and on_demand_paused.
- 在首次运行程序前调用一次 。它每次调用都会反映当前状态;
arcmira_describe可将范围缩小到某个方法。arcmira_describe({ topic }) - 按照下方 ID 规则,先解析问题中的每个名称。过滤器只接受 id。
- 在断言某项被提及之前,先阅读其 description 或 passage,并说明该名称的具体含义(是 Mercury 银行,而不是汞元素)。
- 每个问题编写一个 程序。在同一个程序中解析、检查并运行该问题所需的所有查询。
arcmira_execute_read - 只返回答案需要的字段,不要返回整个 response。
- 搜索中的 as_of 是返回段落中最新的发布日期,而不是整个索引的更新日期。要判断频道内容的新鲜度,请调用 arcmira.status({ channelId }),并针对转录文本搜索报告 channel.search_indexed_through。结果日期或空查询不能证明缺少近期单集。使用 arcmira.today() 和 arcmira.daysAgo(n) 构建日期窗口。如果用户未指定时间窗口,使用最近 90 天;当某个名称返回的结果多于答案所需时,进一步缩小范围。
- 将答案中的每个名称链接到结果携带的 字段。不要手动构建 arcmira.com URL。
page - Premium:返回文本行。如果视频尚未转录,该读取操作会启动转录。仍在处理中时,
arcmira.transcript(video, { quality: "premium" })表示大约还需多长时间;时间过后再次读取。eta_seconds - 用量。计量读取会先使用账户套餐中的 credits,然后使用 dashboard 中设置的按需预算。Arcmira 会强制执行该预算,并且任何工具都不会接受 spending amount。搜索返回的前 5 个段落不收费,此后每返回一个段落使用 4 credits。启动转录的 Premium 读取会报告 charge { unit, amount, from: included | on_demand | mixed };会预先返回该价格(这是价格,不是口述引用),且不消耗 credits。被套餐或预算拦截的读取会抛出 ArcmiraError,其 code 为 paid_plan_required、quota_exceeded、spend_limit_exceeded、member_limit、fair_use_cap 或 on_demand_paused,并附带一条指明限制的 message;如果有报告,还会通过 limit 给出相关数值;当套餐或设置变更解除限制时,还会提供 unlock { tier, url }。账户管理员可以更改 member_limit、fair_use_cap 和 on_demand_paused。
arcmira.quote(video)
Monitors
监控
MONITORS. A monitor sends alerts for the entities it follows, by email to the account address or by Slack, realtime, hourly or daily. arcmira.monitors.list() lists the user's monitors and monitors.trackers(id) what one follows. Changes run only in arcmira_execute_write; nothing is deleted, and update(id, { paused: true }) pauses. Confirm the monitor and its delivery with the user before a write. create needs name and notify_frequency. Slack needs notify_slack: true and a workspace from arcmira.integrations.slack(): its id as slack_integration_id and default_channel_id as slack_channel_id; with none, the user connects one at https://arcmira.com/dashboard/integrations. addEntities takes up to 90 ids in one call. addName follows an exact name that resolve does not find (a show by its UC id). Topic spellings ("data centers", "datacenters") can be separate ids; follow each. A name may already be followed: list() and trackers(id) show what is, so check them before creating a monitor. A result with attached: false names its reason: entity_not_found, entity_type_not_trackable, tracker_limit_reached, or tracked_in_another_monitor (current_monitor_id names it; attachTrackers moves it once the user agrees). Creating a monitor uses no credits; each alert uses 25 credits from the account's plan, then its on-demand budget.
MONITORS。monitor 会针对其跟踪的实体发送提醒,可通过电子邮件发送至账户地址,也可通过 Slack 发送;通知频率可设为实时、每小时或每日。 列出用户的 monitors, 列出一个 monitor 所跟踪的内容。变更操作只能在 中运行;不会删除任何内容, 可暂停 monitor。写入前,先向用户确认 monitor 及其交付方式。 需要 name 和 notify_frequency。Slack 需要 ,以及来自 的 workspace:将其 id 作为 ,将 作为 ;如果尚未配置,用户需在 https://arcmira.com/dashboard/integrations 连接一个。每次 调用最多可添加 90 个 id。 可跟踪 找不到的准确名称(通过其 UC id 表示的节目)。主题的不同拼写("data centers"、"datacenters")可能是不同的 id;每个都要跟踪。某个名称可能已经被跟踪: 和 会显示当前跟踪项,因此创建 monitor 前应先检查。 的结果会说明原因:entity_not_found、entity_type_not_trackable、tracker_limit_reached 或 tracked_in_another_monitor(由 current_monitor_id 指明;用户同意后, 会将其转移过来)。创建 monitor 不消耗 credits;每条提醒先使用账户套餐中的 25 credits,然后使用按需预算。
arcmira.monitors.list()monitors.trackers(id)arcmira_execute_writeupdate(id, { paused: true })createnotify_slack: truearcmira.integrations.slack()slack_integration_iddefault_channel_idslack_channel_idaddEntitiesaddNameresolvelist()trackers(id)attached: falseattachTrackersThe ID rule
ID 规则
ID RULE. Filters take verbatim ids only: entity ids look like ent_14, channel ids like UC-DRzaGnL_vtBUpCFH5M0tg (UC plus 22 characters), video ids are 11 characters or a YouTube URL. A name where an id belongs throws id_required before any network call. Resolve first, then query:
javascript
const r = await arcmira.resolve("Sam", { context: "the My First Million co-host" });
const e = r.best ?? r.suggested; // a show: resolve with { type: "channel" }, use e.youtube_channel_id
if (!e) return { ask: r.ask }; // r.ask.options: [{ id, name, type, label }]RESOLVE ANSWERS ONE OF THREE. best: the name means that row; use it and name it. suggested: no row is certain but one stands out (suggested.reason, suggested.evidence); use it and tell the user you assumed it, quoting the evidence ("Sam Altman, assuming the most mentioned Sam: 4,399 appearances, 11x the next"). ask: several rows fit and none stands out; return ask.options for the user to pick and stop, or check every option id against the data in one program (occurrences or momentum with all the ids) and answer per row, naming each. Resolve the exact name the user said ("ICE", "Mercury"), not a paraphrase, and always pass context with the user's own words about the name when they gave any ("Sam, the My First Million co-host" is resolve("Sam", { context: "the My First Million co-host" })). Context is only words from the user's message, never your own guess: a bare "Theo" is resolve("Theo") with no context, never "Theo Von" or context "the comedian", and its ask goes back to the user. Omit type for a brand (the catalog types some companies as product). A name that resolves to nothing (no best, suggested or ask) is not in the Arcmira index: say so and ask for another spelling or a link; never answer for a different entity without saying so. Always say in the answer which entity you used.
ID 规则。过滤器只接受原样传入的 id:实体 id 形如 ,频道 id 形如 (UC 加 22 个字符),视频 id 为 11 个字符或一个 YouTube URL。在需要 id 的位置传入名称,会在发生任何网络调用之前抛出 。请先解析,再查询:
ent_14UC-DRzaGnL_vtBUpCFH5M0tgid_requiredjavascript
const r = await arcmira.resolve("Sam", { context: "the My First Million co-host" });
const e = r.best ?? r.suggested; // a show: resolve with { type: "channel" }, use e.youtube_channel_id
if (!e) return { ask: r.ask }; // r.ask.options: [{ id, name, type, label }]resolve 的结果有三种。:该名称明确指向这条记录;使用它并说明其名称。:没有记录完全确定,但有一个候选明显更突出(、);可以使用它,但要告诉用户你做了此假设,并引用相关证据("Sam Altman, assuming the most mentioned Sam: 4,399 appearances, 11x the next")。:有多个记录都符合,且没有任何一个明显突出;向用户返回 以供选择并停止,或在同一个程序中用所有 id 检查数据(出现次数或热度),然后逐条回答并注明每个实体。解析用户所说的准确名称("ICE"、"Mercury"),不要改写;如果用户提供了关于名称的说明,始终使用用户原话作为 context("Sam, the My First Million co-host" 对应 )。context 只能使用用户消息中的原话,绝不能使用你自己的推测:单独的 "Theo" 应使用不带 context 的 ,不能写成 "Theo Von",也不能添加 context "the comedian";如果得到 ask,应交回用户选择。对于品牌,不要传入 type(目录会将某些公司归类为 product)。如果某个名称解析后没有任何结果(既无 best、suggested,也无 ask),说明它不在 Arcmira 索引中,并请用户提供其他拼写或链接;绝不能在不说明的情况下回答另一个实体。始终在答案中说明使用了哪个实体。
bestsuggestedsuggested.reasonsuggested.evidenceaskask.optionsresolve("Sam", { context: "the My First Million co-host" })resolve("Theo")Docs
文档
- API reference: https://arcmira.com/docs/api-reference
- MCP guide: https://arcmira.com/docs/mcp-server
- Error codes: https://arcmira.com/docs/errors
- OpenAPI: https://api.arcmira.com/v1/openapi.json
- Agent index: https://arcmira.com/llms.txt
After the answer
回答之后
Monitors can follow what a research turn found, and each alert uses 25 credits from the account's plan, then its on-demand budget. The skill sets one up.
company-watchIf anything was wrong, slow, or missing for the user, send one arcmira_feedback.
monitor 可以跟踪某次研究发现的内容,每条提醒先使用账户套餐中的 25 credits,然后使用按需预算。 skill 可以设置一个 monitor。
company-watch如果有任何错误、响应过慢或对用户而言有缺失,发送一次 。
arcmira_feedback