Back to Details

miro-browse

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Browse Miro Board Contents

浏览Miro白板内容

List and explore items on a Miro board with optional filtering.
列出并浏览Miro白板上的项目，支持可选筛选。

Inputs

输入信息

Identify from the user's request:
  1. board-url (required): Miro board URL
  2. item-type (optional): Type of items to filter
从用户请求中确定以下内容：
  1. board-url（必填）：Miro白板URL
  2. item-type（可选）：要筛选的项目类型

Item Types

项目类型

  • frame
    - Frames/containers
  • sticky_note
    - Sticky notes
  • card
    - Card widgets
  • shape
    - Shapes
  • text
    - Text elements
  • image
    - Images
  • document
    - Documents
  • embed
    - Embedded content
  • frame
    - 框架/容器
  • sticky_note
    - 便签
  • card
    - 卡片组件
  • shape
    - 形状
  • text
    - 文本元素
  • image
    - 图片
  • document
    - 文档
  • embed
    - 嵌入内容

Workflow

工作流程

  1. If board URL is missing, ask the user for it
  2. Call 
    board_list_items
    with the board URL, requesting up to 50 items. Apply type filter if the user specified one. If the URL contains a moveToWidget parameter, scope to that container.
  3. Present the items in a readable format:
    • Show item type, ID, and relevant content/title
    • Group by type if showing mixed items
  4. If there are more items (cursor returned), offer to load more
  5. Offer follow-up actions:
    • Focus on a specific frame
    • Filter by a different type
    • Get details about a specific item
  1. 如果缺少白板URL，询问用户提供该URL
  2. 调用
    board_list_items
    工具，传入白板URL，请求最多50个项目。如果用户指定了类型，则应用类型筛选。如果URL包含moveToWidget参数，则限定在该容器内。
  3. 以易读格式展示项目：
    • 显示项目类型、ID以及相关内容/标题
    • 如果展示混合类型项目，按类型分组
  4. 如果还有更多项目（返回cursor），提供加载更多选项
  5. 提供后续操作选项：
    • 聚焦特定框架
    • 按其他类型筛选
    • 获取特定项目的详细信息

Examples

示例

User input: 
list items on https://miro.com/app/board/abc=
Action: List all items on the board (first page).
User input: 
show me frames on https://miro.com/app/board/abc=
Action: List only frames on the board.
User input: 
what's inside https://miro.com/app/board/abc=/?moveToWidget=123
Action: List items within the specified frame/container.
用户输入： 
list items on https://miro.com/app/board/abc=
操作： 列出白板上的所有项目（第一页）。
用户输入： 
show me frames on https://miro.com/app/board/abc=
操作： 仅列出白板上的框架。
用户输入： 
what's inside https://miro.com/app/board/abc=/?moveToWidget=123
操作： 列出指定框架/容器内的项目。

Output Format

输出格式

Present items clearly:
undefined
清晰展示项目：
undefined

Frames (3 found)

Frames (3 found)

  • Design Specs (ID: 3458764612345)
  • User Flows (ID: 3458764612346)
  • Component Library (ID: 3458764612347)
  • Design Specs (ID: 3458764612345)
  • User Flows (ID: 3458764612346)
  • Component Library (ID: 3458764612347)

Sticky Notes (12 found)

Sticky Notes (12 found)

  • "User feedback: navigation confusing" (ID: 3458764612350)
  • "TODO: Update color palette" (ID: 3458764612351) ...
undefined
  • "User feedback: navigation confusing" (ID: 3458764612350)
  • "TODO: Update color palette" (ID: 3458764612351) ...
undefined

Follow-up Actions

后续操作

After listing items, suggest relevant next steps:
  • "Would you like to explore items inside a specific frame?"
  • "Should I get the content/summary of this board?"
  • "Want to see images or download any specific item?"
列出项目后，建议相关后续步骤：
  • "是否想要浏览特定框架内的项目？"
  • "是否需要获取该白板的内容/摘要？"
  • "是否想要查看图片或下载特定项目？"

Board URLs and IDs

白板URL与ID

Miro tools accept board URLs directly. Extract 
board_id
and 
item_id
automatically from URLs like:
  • https://miro.com/app/board/uXjVK123abc=/
    — Board URL
  • https://miro.com/app/board/uXjVK123abc=/?moveToWidget=3458764612345
    — URL with item focus
When a URL includes 
moveToWidget
or 
focusWidget
, the 
item_id
is extracted automatically.
Miro工具直接接受白板URL。自动从以下格式的URL中提取
board_id
和
item_id
：
  • https://miro.com/app/board/uXjVK123abc=/
    — 白板URL
  • https://miro.com/app/board/uXjVK123abc=/?moveToWidget=3458764612345
    — 带有项目聚焦的URL
当URL包含
moveToWidget
或
focusWidget
时，会自动提取
item_id
。

Related Tools

相关工具

For deeper exploration beyond 
board_list_items
, prefer these tools:
ToolWhen to use
context_explore
High-level summary of a board's frames, documents, prototypes, tables, and diagrams (with their URLs). Best first call when the user asks "what's on this board?".
context_get
Detailed content for a specific item URL (with 
moveToWidget
). Returns HTML for documents/prototype screens, AI-generated summaries for frames/diagrams, structured data for tables.
image_get_url
Download URL for an image item.
image_get_data
Image content directly.
doc_get
Document content and version (use before 
doc_update
for find-and-replace edits).
除
board_list_items
外，如需更深入的浏览，优先使用以下工具：
工具使用场景
context_explore
对白板的框架、文档、原型、表格和图表（及其URL）进行高层级摘要。当用户询问“这个白板上有什么？”时，这是最佳的首次调用工具。
context_get
获取特定项目URL（带有
moveToWidget
）的详细内容。返回文档/原型屏幕的HTML、框架/图表的AI生成摘要、表格的结构化数据。
image_get_url
图片项目的下载URL。
image_get_data
直接获取图片内容。
doc_get
获取文档内容和版本（在使用
doc_update
进行查找替换编辑前使用）。

Summarizing a board

白板摘要

When the user wants a summary of a whole board:
  1. Call 
    context_explore
    to discover what's on the board.
  2. Present the high-level inventory.
  3. For items the user wants to dig into, call 
    context_get
    with the item URL.
当用户想要整个白板的摘要时：
  1. 调用
    context_explore
    工具发现白板上的内容。
  2. 展示高层级的内容清单。
  3. 对于用户想要深入了解的项目，调用
    context_get
    工具并传入项目URL。