# Yutori — Pipedream Connect

> Build with Yutori’s state-of-the-art web agents that can autonomously monitor and execute tasks on the web.

- API slug: `yutori` (use in MCP headers and tool keys)
- Auth: API key (Pipedream-managed)
- Categories: Artificial Intelligence (AI)
- Website: https://yutori.com/api
- This page (HTML): https://pipedream.com/apps/yutori
- Tools: 6 actions · 1 trigger

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: yutori`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "yutori",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Get Browsing Task Result:
const result = await mcp.callTool({
  name: "yutori-get-browsing-task-result",
  arguments: {
    taskId: "Task ID",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Yutori endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.yutori.com/v1/usage

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkueXV0b3JpLmNvbS92MS91c2FnZQ?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "yutori-get-browsing-task-result",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    yutori: { authProvisionId: "apn_xxxxxxx" },
    taskId: "Task ID",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (6)

### `yutori-get-browsing-task-result` — Get Browsing Task Result (Read-only)

Fetch the current status and result of a browsing task started with Run Browsing Task. Place a Delay step (15 minutes recommended) before this action to give the task time to complete. If the task is still running, the step returns the current status — re-run or increase the delay if needed. See…

Full schema: https://pipedream.com/apps/yutori/actions/get-browsing-task-result.md

### `yutori-get-research-task-result` — Get Research Task Result (Read-only)

Fetch the current status and result of a research task started with Run Research Task. Place a Delay step (15 minutes recommended) before this action to give the task time to complete. Research tasks typically take 5–15 minutes. If the task is still running, the step returns the current status…

Full schema: https://pipedream.com/apps/yutori/actions/get-research-task-result.md

### `yutori-get-scout` — Get Scout (Read-only)

Fetch the details and current status of a specific Yutori Scout by its ID. Returns the scout's configuration, status (active, paused, completed), and metadata. See the documentation

Full schema: https://pipedream.com/apps/yutori/actions/get-scout.md

### `yutori-get-scout-updates` — Get Scout Updates (Read-only)

Fetch the latest findings from a specific Yutori Scout. Returns updates in reverse chronological order. Use the New Scout Update trigger for event-driven workflows; use this action when you need to pull findings on demand. See the documentation

Full schema: https://pipedream.com/apps/yutori/actions/get-scout-updates.md

### `yutori-run-browsing-task` — Run Browsing Task (Write)

Use Yutori's cloud browser agent to navigate a website, fill forms, extract data, or complete any multi-step task — just describe it in plain English. Returns a task ID immediately; provide a Webhook URL to receive the full result the moment the task finishes. See the documentation

Full schema: https://pipedream.com/apps/yutori/actions/run-browsing-task.md

### `yutori-run-research-task` — Run Research Task (Write)

Use Yutori to run deep web research across 100+ sources and get a comprehensive findings report — competitive analysis, market research, pricing comparisons, and more. Returns a task ID immediately; provide a Webhook URL to receive the full findings the moment research completes. See the…

Full schema: https://pipedream.com/apps/yutori/actions/run-research-task.md

## Triggers (1)

### `yutori-new-scout-update` — New Scout Update (Polling)

Emit new findings from a Yutori Scout. Configure your scout once here — it is created automatically when this source is deployed and deleted when it is disabled. Each new finding emits an event you can act on with downstream steps (e.g. send a Slack message, update a Google Sheet, or post to…

Full schema: https://pipedream.com/apps/yutori/triggers/new-scout-update.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt