View as Markdown
Yutori icon

Yutori ACTION

Run Research Task

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 documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Yutori account once, then configure and run Run Research Task from your backend or agent.

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-run-research-task",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    yutori: { authProvisionId: "apn_xxxxxxx" },
    query: "Research Query",
    userTimezone: "Timezone",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Run Research Task inputs
Property Type Description
query Research Query string
What to research, e.g. What are the top 5 CRM tools for startups in 2025, with pricing?
Required
userTimezone Timezone string
Your timezone, e.g. America/Los_Angeles
Optional
userLocation Location string
Your location, e.g. San Francisco, CA, US
Optional
webhookUrl Webhook URL string
URL to receive the result when research completes. Recommended for reliable delivery — Yutori will POST the findings to this URL.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
yutori-run-research-task
Version
0.0.2
App
Yutori
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes