Felo API PlatformFelo API Platform

ریسرچ

اسٹاک منگوانے سے پہلے پروڈکٹ نیش کی تحقیق کریں

زمرہ سیاق جمع کریں، اعلان شدہ تاریخ پر حریف صفحات کیپچر کریں، X پر خریدار شکایات پڑھیں اور آرڈر سے پہلے جائزے کے لیے ثبوت اور میمو ایک LiveDoc میں رکھیں۔

وقت30 منٹسطحدرمیانہاپ ڈیٹ2026-10-30
کिसके لیےای کامرس آپریٹرزپروڈکٹ محققینDTC بانیان

پرامپٹ کاپی کریں

مربع بریکٹ کے فیلڈز بدلیں اور Claude Code، Codex یا ٹرمینل رسائی والے AI میں چسپاں کریں۔ یہ Felo اسکل نصب کرتا ہے، کریڈٹ سے پہلے پوچھتا ہے اور ورک فلو چلاتا ہے۔

اسٹاک یا لانچ سے پہلے اس مصنوعات کی نیش پر تحقیق کریں: [مصنوعات یا زمرہ]۔

مارکیٹ: [ملک یا علاقہ]۔ چینل: [مارکیٹ پلیس / DTC / ریٹیل]۔ خریداروں کی پوسٹوں کی مدت: گزشتہ [30] دن۔
موازنہ مصنوعات یا حریف URLs: [URLs]۔ بجٹ اور مارجن کی حدود: [حدود]۔ قارئین: [ٹیم]۔

Markdown میمو میں شامل ہوں:
1. ایک پیراگراف کا فیصلہ: کیا مزید تحقیق قابلِ قدر ہے، اور کیا آپ کی رائے بدلے گا۔
2. طلب کے اشارے: ذرائع دلچسپی، موسمی نوعیت اور متبادلات کے بارے میں کیا کہتے ہیں۔
3. حریف مصنوعات: ہر ایک کیا دعویٰ کرتی ہے، صفحے پر درج قیمت اور جہاں خریدار کمی بتاتے ہیں۔
4. قیمت کی پوزیشننگ: صفحوں پر واقعی ملی قیمتیں، ہر ایک درج تاریخ کے ساتھ۔
5. خریداروں کی شکایات اور ادھوری ضروریات، حوالوں، اکاؤنٹس اور تاریخوں کے ساتھ۔
6. اسٹاک خریدنے سے پہلے حل کرنے والے خطرات اور کھلے سوالات۔
7. ذرائع: استعمال شدہ ہر صفحہ اور پوسٹ، URL اور تاریخ کے ساتھ۔

قواعد:
- صرف وہی استعمال کریں جو API واپس کرتا ہے۔ مارکیٹ کا حجم، فروخت کا اندازہ، جائزوں کی تعداد یا حریف کی قیمت کبھی نہ گھڑیں۔
- قیمتیں ویسے ہی بتائیں جیسے درج ہوئیں، صفحے کے URL اور درج تاریخ کے ساتھ۔ کبھی اوسط یا نارملائز نہ کریں۔
- X پوسٹوں کو واقعہ سمجھیں، مارکیٹ ڈیٹا نہیں، اور نمونہ کمزور ہو تو بتائیں۔
- فروشندہ کے دعوے کو خریدار کی رپورٹ سے الگ کریں۔
- کریڈٹ خرچ کرنے سے پہلے منصوبہ بند اخراج اور تلاشیں دکھائیں اور میری منظوری کا انتظار کریں۔
- سپلائرز سے رابطہ نہ کریں، آرڈر نہ دیں اور X پر کسی ko پیغام نہ بھیجیں۔
- نتیجہ ./product-research.md میں لکھیں اور چیٹ میں خلاصہ دیں۔

کاپی میں تنصیب کے مراحل اور حفاظتی اصول بھی شامل ہیں۔

آپ کو کیا ملتا ہے

ایک رن کی مثال آؤٹ پٹ۔ لائیو جنریشن نہیں۔

نمونہ میمو (اقتباس)

پروڈکٹ تحقیق — نمونہ زمرہ

فیصلہ

قریب سے دیکھنے کے قابل ہے، لیکن عوامی شواہد اسٹاک کے فیصلے کے لیے کافی نہیں۔ نیچے کے کھلے سوالات اگلا قدم ہیں۔

زمرے کا سیاق

خریدار دباؤ سے زیادہ کاؤنٹر کی جگہ اور صفائی کا موازنہ کرتے ہیں۔ کوئی عوامی ذریعہ مارکیٹ سائز کے اندازے کی حمایت نہیں کرتا۔

حریف صفحات

  • Example A — پروڈکٹ صفحہ (2026-10-30 محفوظ)
  • Example B — پروڈکٹ صفحہ (2026-10-30 محفوظ)

خریدار کیا بتاتے ہیں

  • @example_buyer: «ایک سال میں تیسری تبدیلی؛ سیل خراب ہوتی ہے»۔ — 2026-10-19
  • @example_home: «صفائی میں منٹ لگتے ہیں، کوئی نہیں بتاتا»۔ — 2026-10-24

قیمت کی پوزیشننگ

قیمتیں 2026-10-30 کو لنک شدہ صفحات سے محفوظ کی گئیں۔ دو درجوں میں ہیں؛ ہر صفحہ براہ راست نقل، اوسط نہیں۔

خطرات اور کھلے سوالات

  • سیل کی پائیداری سب سے بار بار شکایت ہے۔
  • کوئی ذریعہ واپسی کی شرح کا احاطہ نہیں کرتا۔
  • آرڈر سے پہلے سپلائر لیڈ ٹائم اور لینڈڈ کاسٹ جانچیں۔

ذرائع

  • https://example.com/product-a — 2026-10-30
  • https://x.com/example_buyer/status/... — 2026-10-19

درست کالز

ڈویلپرز کے لیے: وہی ورک فلو کوڈ کے طور پر، چلانے کی ترتیب میں۔

اصل API کالز دکھائیں
  1. Chat سے زمرہ تصویر مانگیں

    ذرائع والے جواب سے شروع کریں، خالی صفحے سے نہیں: Chat عوامی ویب تلاش کرتا ہے، صفحات ترتیب دیتا ہے اور استعمال شدہ وسائل واپس کرتا ہے۔ ایک سوال میں مانگ سیاق، متبادل اور عام شکایات پوچھیں، پھر اعلیٰ وسائل ثبوت فہرست کے طور پر رکھیں۔

    product-research.ts
    const BASE = "https://openapi.felo.ai";
    const headers = {
      Authorization: `Bearer ${process.env.FELO_API_KEY}`,
      "Content-Type": "application/json",
    };
    
    async function felo<T>(path: string, body?: unknown): Promise<T> {
      const res = await fetch(`${BASE}${path}`, {
        method: body ? "POST" : "GET",
        headers,
        body: body ? JSON.stringify(body) : undefined,
      });
      if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
      return res.json() as Promise<T>;
    }
    
    type ChatData = {
      data: {
        answer: string;
        resources: { link: string; title: string; snippet: string }[];
      };
    };
    
    const niche = "portable espresso maker"; // replace with the category you are judging
    
    const context = await felo<ChatData>("/v2/chat", {
      query: `Demand, price bands, and buyer complaints for ${niche} in the US`,
    });
    
    const sources = context.data.resources.slice(0, 5);

    مثال آؤٹ پٹ

    {
      "answer": "Buyers compare on counter space and cleanup …",
      "sources": [
        { "link": "https://example.com/category-guide", "title": "…", "snippet": "…" }
      ]
    }
  2. حریف صفحات کیپچر کریں

    دو یا تین حریف پروڈکٹ صفحات پڑھنے کے موڈ کے ساتھ Markdown میں نکالیں۔ مقصد آج کے صفحے کا دعوہ اور قیمت ہے، دوبارہ لکھی اسپیک شیٹ نہیں۔ URL مواد کے ساتھ رکھیں اور کیپچر تاریخ لکھیں: بغیر تاریخ قیمت افواہ ہے۔

    product-research.ts
    const PRODUCT_PAGES = [
      { url: "https://example.com/product-a", title: "Example A — product page" },
      { url: "https://example.com/product-b", title: "Example B — product page" },
    ];
    
    type ExtractData = { data: { content: string } };
    
    const listings = await Promise.all(
      PRODUCT_PAGES.map((page) =>
        felo<ExtractData>("/v2/web/extract", {
          url: page.url,
          output_format: "markdown",
          with_readability: true,
        }).then((extracted) => ({ ...page, content: extracted.data.content })),
      ),
    );

    مثال آؤٹ پٹ

    [
      {
        "url": "https://example.com/product-a",
        "title": "Example A — product page",
        "content": "# Example A\n\nSpecs and price as displayed…"
      }
    ]
  3. X پر خریدار کیا بتاتے ہیں پڑھیں

    سپلائر صفحات خصوصیات بتاتے ہیں؛ خریدار ناکامیاں بیان کرتے ہیں۔ نیش کو رگڑ کے الفاظ — ڈیلیوری، معیار، واپسی — کے ساتھ 30 دن تلاش کریں اور اکاؤنٹ، تاریخ، لنک رکھیں۔ یہ واقعات ہیں، مانگ ڈیٹا نہیں، اور میمو کو یہ بتانا چاہیے۔

    product-research.ts
    type XData = {
      data: {
        tweets: {
          content: string;
          author: { username: string };
          created_at: string;
          metrics: { retweet_count: number; favorite_count: number; reply_count: number };
          url: string;
        }[];
      };
    };
    
    const since = Math.floor((Date.now() - 30 * 24 * 60 * 60 * 1000) / 1000);
    
    const search = await felo<XData>("/v2/x/tweet/search", {
      query: `"${niche}" (shipping OR quality OR refund)`,
      limit: 50,
      since_time: since,
    });
    
    const complaints = search.data.tweets;

    مثال آؤٹ پٹ

    { "data": { "tweets": [
      {
        "content": "Third replacement in a year; the seal fails.",
        "author": { "username": "example_buyer" },
        "created_at": "2026-10-19T15:02:00Z",
        "metrics": { "retweet_count": 1, "favorite_count": 12, "reply_count": 3 },
        "url": "https://x.com/example_buyer/status/..."
      }
    ] } }
  4. میمو لکھیں

    یہ مرحلہ سادہ کوڈ ہے: زمرہ جواب، کیپچر تاریخیں، خریدار حوالے اور ذرائع فہرست ایک Markdown میں ملائیں۔ کھلے سوالات میں ایماندار رہیں — میمو اس لیے مفید ہے کہ یہ صفحات کے ثبوت کو سپلائر سے تصدیق طلب چیز سے الگ کرتا ہے۔

    product-research.ts
    const capturedOn = new Date().toISOString().slice(0, 10);
    
    const memo = [
      `# Product research — ${niche}`,
      "",
      "## Category context",
      context.data.answer,
      "",
      "## Competitor pages",
      ...listings.map(
        (page) => `- [${page.title}](${page.url}) — captured ${capturedOn}`,
      ),
      "",
      "## What buyers report",
      ...complaints.slice(0, 10).map(
        (post) =>
          `- @${post.author.username} (${post.created_at.slice(0, 10)}): ${post.content}`,
      ),
      "",
      "## Sources",
      ...sources.map((source) => `- [${source.title}](${source.link})`),
    ].join("\n");
    
    console.log(memo);
  5. ثبوت LiveDoc میں محفوظ کریں

    فی نیش ایک بار چلائیں: LiveDoc بنائیں اور short_id کنفیگ میں رکھیں۔ حریف صفحات اور Chat ذرائع URL وسائل کے طور پر شامل کریں تاکہ محفوظہ ڈپلیکیٹ ہٹائے، پھر میمو دستاویز کے طور پر۔ خرید سے پہلے کیپچر تلاش کریں اور دیکھیں کون سی قیمتیں ہلیں۔

    product-research.ts
    type LiveDocData = { data: { short_id: string } };
    
    const research = await felo<LiveDocData>("/v2/livedocs", {
      name: `Product research: ${niche}`,
      description: "Competitor pages, buyer posts, and the memo",
    });
    
    await felo(`/v2/livedocs/${research.data.short_id}/resources/urls`, {
      urls: [
        ...listings.map((page) => ({ url: page.url, title: page.title })),
        ...sources.map((source) => ({ url: source.link, title: source.title })),
      ].slice(0, 10),
    });
    
    await felo(`/v2/livedocs/${research.data.short_id}/resources/doc`, {
      title: `Product memo — ${capturedOn}`,
      content: memo,
    });

    مثال آؤٹ پٹ

    { "short_id": "PvyKouzJirXjFdst4uKRK3" }

کیا شامل ہے

  • Chat سے ذرائع والی زمرہ تصویر اور پیچھے کے صفحات
  • کیپچر تاریخ کے ساتھ حریف صفحات Markdown میں
  • اکاؤنٹ، تاریخ اور لنک والی X خریدار شکایات
  • ان ان پٹس سے لکھا Markdown میمو
  • ایک LiveDoc جس میں ثبوت اور میمو

کیا نہیں کرتا

  • صرف عوامی ذرائع؛ ادائیگی رپورٹس، سپلائر کوٹیشنز اور اندرونی فروخت دائرے سے باہر
  • مارکیٹ سائز، حجم یا مارجن کا اندازہ نہیں
  • قیمتیں کیپچر کے مطابق درج، نارملائز یا اوسط نہیں
  • X پوسٹس واقعات ہیں، مانگ ڈیٹا نہیں
  • سپلائر سے رابطہ نہیں، آرڈر نہیں اور لسٹنگ تبدیل نہیں کرتا

سوالات

مارکیٹ سیاق کہاں سے؟

Chat API ذرائع والا جواب اور استعمال شدہ عوامی صفحات واپس کرتا ہے۔ حریف صفحات آپ کے URLs سے اور Web Fetch نکالتا ہے؛ خریدار پوسٹس X Search سے۔ کوئی نجی فروخت ڈیٹا نہیں۔

کیا بتاتا ہے پروڈکٹ بکے گا؟

نہیں۔ یہ عوامی ثبوت — سیاق، کیپچر قیمتیں اور شکایات — ترتیب دیتا ہے اور جو نامعلوم ہے لکھتا ہے۔ مانگ کی تصدیق کے لیے آپ کا ڈیٹا چاہیے: اشتہارات، پیشگی آرڈر یا سپلائر گفتگو۔

اگر مارکیٹ پلیس ایکسٹریکشن روکے؟

Web Fetch ایک وقت میں ایک عوامی URL لاتا ہے اور کچھ سائٹس روکتی ہیں۔ قابل رسائی پروڈکٹ یا سپلائر صفحہ استعمال کریں اور میمو کو قیمت کا اندازہ لگانے کے بجائے چھوٹا کیپچر نشان زد کرنے دیں۔

پرانی حریف قیمتوں سے کیسے بچیں؟

میمو کی ہر قیمت URL اور کیپچر تاریخ سے بندھی ہے۔ خرید فیصلے کے قریب ایکسٹریکشن دوبارہ چلائیں؛ محفوظہ پچھلے کیپچر رکھتا ہے تاکہ حرکت دکھے۔

کیا سپلائر یا فروخت کنندہ سے رابطہ کرتا ہے؟

نہیں۔ ورک فلو صرف پڑھتا ہے: صفحات نکالتا، عوامی پوسٹس تلاش کرتا اور مقامی میمو لکھتا ہے۔ پیغام نہیں بھیجتا، آرڈر نہیں کرتا اور لسٹنگ تبدیل نہیں کرتا۔

ایک تحقیق کی لاگت کتنی ہے؟

ہر Chat، ایکسٹریکشن اور X تلاش استعمال کے مطابق کریڈٹ لیتی ہے؛ موجودہ نرخ قیمت صفحے پر۔ پرامپٹ خرچ سے پہلے منظوری مانگتا ہے۔

متعلقہ ورک فلو

اسے اپنا بنائیں

وہی ترکیب، آپ کے اصل انداز کے مطابق۔

ویڈیو ریویو ٹرانسکرپٹس شامل کریں

جب زمرے میں ویڈیو ریویوز ہوں، YouTube Subtitling سے ٹرانسکرپٹ لیں اور خریدار حصے میں دو یا تین ٹائم اسٹیمپ حوالے شامل کریں۔ ویڈیو ریویو ایک شخص کا تجربہ ہے: واقعہ لیبل رکھیں۔

دو امیدواروں کا موازنہ

ہر امیدوار پر وہی مراحل چلائیں اور میمو ساتھ رکھیں: دعوہ شدہ خصوصیات، کیپچر قیمت، دہرائی جانے والی شکایت اور کھلا سوال۔ موازنہ آپ کے فروخت یا واپسی ڈیٹا تک معیاری رہتا ہے۔

خرید سے پہلے اپ ڈیٹ

آرڈر سے ایک دن پہلے ایکسٹریکشن دوبارہ چلائیں۔ وہی LiveDoc رکھیں اور نیا میمو شامل کریں تاکہ محفوظہ تحقیق اور خرید کے درمیان تبدیلی دکھائے۔

اس ترکیب کے پیچھے کے ریفرنس صفحات اور اگلے مراحل۔