{
 "schema_version": 1,
 "generated": "2026-10-20",
 "id": "socai-io-jev-social--cited-social-research-report",
 "repo": "socai-io/jev-social",
 "repo_url": "https://github.com/socai-io/jev-social",
 "repo_slug": "socai-io-jev-social",
 "title": "Build a source-cited social research report",
 "page_title": "How to build a source-cited social research report with Jev Social",
 "summary": "Run a read-only research goal across Instagram, TikTok, or LinkedIn and get a cited Markdown report.",
 "who": "A market researcher or analyst who needs to understand what people are posting about a topic on one or more social platforms.",
 "problem": "Manually reading social feeds is slow, and findings are hard to trace back to specific public posts or profiles.",
 "outcome": "A report.md where each accepted finding cites a captured source, plus a history of every operation Jev chose.",
 "steps": [
  "Install Node 22 or newer and sign in to Instagram, TikTok, or LinkedIn in Chrome.",
  "`npx github:socai-io/jev-social#v0.1.13 onboard`",
  "`npx github:socai-io/jev-social#v0.1.13`",
  "Enter a research goal naming the platform, for example: find handmade art on Instagram.",
  "Open the downloaded report.md and check that each finding links to a captured source."
 ],
 "agent_prompt": "Use the socai-io/jev-social repo to research <topic> on <platform> in my signed-in Chrome. Expected output: a source-cited report.md. Verify that every finding links to a captured source URL and that any login gate is reported as a partial result, not a success.",
 "agents": [
  "any"
 ],
 "difficulty": "Intermediate",
 "time": "30 minutes",
 "basis": "readme",
 "caveat": "Login gates and step limits produce partial results, and report synthesis may incur OpenRouter usage unless OPENROUTER_REPORT_MODEL=off is set.",
 "category": "Research",
 "tags": [
  "Research"
 ],
 "lang": "javascript",
 "requirements": [
  "Node 22 or newer",
  "Chrome already signed in to Instagram, TikTok, or LinkedIn",
  "An OpenRouter API key for the default decision provider",
  "A current socai CLI (onboarding can install it on macOS and Windows; on Linux install it first and set it on PATH or SOCAI_BIN)"
 ],
 "risk": "sensitive",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "credentials",
   "notice": "Jev runs in the Chrome profile you select, so use a separate profile or test account for sensitive research."
  }
 ],
 "best": true,
 "score": 1.0,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/socai-io-jev-social/cited-social-research-report/",
 "md": "https://dedupedai.com/use-cases/socai-io-jev-social/cited-social-research-report/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/socai-io-jev-social--cited-social-research-report.json",
 "api_version": "v1"
}