Open-source, local-first social media research agent for Instagram, TikTok, and LinkedIn. Jev routes read-only steps; socai CLI captures cited browser evidence.
JavaScript agent-skillsai-agentsbrowser-agentbrowser-automationdecision-modeldeep-researchinstagramjevlinkedinlocal-firstopen-sourceosintresearch-agentsocaisocial-listeningsocial-mediasocial-media-researchsocmintsystem-onetiktok
docs: keep Jev Social promotion separate (#63)
Asklvaaeeaf49e57e
diff --git a/README.md b/README.mdindex a70717c..74cde81 100644--- a/README.md+++ b/README.md@@ -12,7 +12,7 @@<a href="https://ossdrop.com/tool/jev-social"><img src="https://ossdrop.com/badge/jev-social" alt="#1 Tool of the Day on OSSDrop" width="250" height="56"></a>-Jev chooses each next operation: search, open a particular post or profile, read comments, explicitly requested TikTok media download, or finish. [socai](https://github.com/socai-io/socai) executes the selected CLI command in your real Chrome. Each result goes back to Jev before the next decision.+Jev chooses each next operation: search, open a particular post or profile, read comments, explicitly requested TikTok media download, or finish. The local `socai CLI` executes the selected command in your real Chrome. Each result goes back to Jev before the next decision.<p><img src="https://raw.githubusercontent.com/socai-io/jev-social/main/docs/platforms/instagram.png" height="32" alt="Instagram">@@ -22,7 +22,7 @@ Jev chooses each next operation: search, open a particular post or profile, read<img src="https://raw.githubusercontent.com/socai-io/jev-social/main/docs/platforms/linkedin.svg" height="32" alt="LinkedIn"></p>-[Live site](https://socai-io.github.io/jev-social/) · [Real 64-second Jev report](docs/example-report.md) · [Recorded TikTok video evidence](docs/tiktok-evidence.md) · [Product story](https://socai.io/blog/jev-social-media-automation/) · [socai](https://github.com/socai-io/socai) · [Discord](https://discord.gg/CpQdA7bwt8) · [Jev](https://typesafe.ai/)+[Live site](https://socai-io.github.io/jev-social/) · [Social research guide](https://socai-io.github.io/jev-social/social-research/) · [Real 64-second Jev report](docs/example-report.md) · [Recorded TikTok video evidence](docs/tiktok-evidence.md) · [Discord](https://discord.gg/CpQdA7bwt8) · [Jev](https://typesafe.ai/)## Try it@@ -41,7 +41,7 @@ The recording above shows the earlier routing-only prototype. Current runs inclu## Why this pairing-Jev chooses from a changing list of concrete, read-only operations. The list includes exact targets discovered in previous results, so Jev decides which post to open and which socai command to run. socai handles the underlying navigation, clicks, scrolling, and extraction; Jev does not choose arbitrary DOM coordinates or generate shell commands.+Jev chooses from a changing list of concrete, read-only operations. The list includes exact targets discovered in previous results, so Jev decides which post to open and which `socai CLI` operation to run. The local CLI handles the underlying navigation, clicks, scrolling, and extraction; Jev does not choose arbitrary DOM coordinates or generate shell commands.```text"find handmade art on Instagram"@@ -96,7 +96,7 @@ No live benchmark results are published yet. The commands, row contract, timing## Run it-Node 20+, a decision provider (OpenRouter Jev or a loopback Kev server), and a current [socai](https://github.com/socai-io/socai) CLI.+Node 20+, a decision provider (OpenRouter Jev or a loopback Kev server), and a current `socai CLI`.Fastest OpenRouter path — no repository clone required. Onboarding prompts for the key and offers to install the official socai CLI when it is missing:@@ -133,12 +133,13 @@ The skill pins the documented Jev Social CLI release, preserves its read-only anTo work from a source checkout instead:+On macOS and Windows, onboarding can install a missing `socai CLI`. On Linux, install a current `socai CLI` separately, then put it on `PATH` or set `SOCAI_BIN` before onboarding.+```bash-curl -fsSL https://github.com/socai-io/socai/releases/latest/download/install.sh | shgit clone https://github.com/socai-io/jev-social.gitcd jev-socialnpm install-cp .env.example .env # OPENROUTER_API_KEY=…+npm start -- onboardnpm start```@@ -177,16 +178,6 @@ npm start -- search "find handmade art on Instagram and read the comments" --limFor browser connection checks, platform login barriers, and safe status diagnostics, see [Troubleshooting](https://github.com/socai-io/jev-social/blob/main/docs/troubleshooting.md).-Or call socai directly:--```bash-socai instagram search "AI wearables" --num 10 --pretty-socai tiktok search "AI wearables" --num 10 --pretty-socai tiktok get-videos --video <url> --download-media --pretty-socai linkedin search "AI product managers" --num 10 --pretty-socai linkedin search "AI agents" --type content --num 10 --pretty-```-----If this is useful, [star Jev Social](https://github.com/socai-io/jev-social/stargazers). The browser runtime lives in [socai](https://github.com/socai-io/socai); you can star it too or [join the Discord](https://discord.gg/CpQdA7bwt8).+If this is useful, [star Jev Social](https://github.com/socai-io/jev-social/stargazers) or [join the Discord](https://discord.gg/CpQdA7bwt8).diff --git a/test/distribution-docs.test.js b/test/distribution-docs.test.jsindex d9019cb..e741122 100644--- a/test/distribution-docs.test.js+++ b/test/distribution-docs.test.js@@ -216,6 +216,36 @@ test("the Pages landing exposes current structured metadata and recorded evidencassert.doesNotMatch(landing, /https:\/\/(?:www\.)?socai\.io/);});+test("the README keeps Jev Social promotion separate from the socai runtime", async () => {+ const readme = await readFile(new URL("../README.md", import.meta.url), "utf8");+ const sourceCheckout = readme.match(+ /To work from a source checkout instead:\r?\n[\s\S]*?```bash\r?\n([\s\S]*?)\r?\n```/,+ );++ assert.match(readme, /\bsocai CLI\b/);+ assert.match(readme, /star Jev Social/i);+ assert.ok(sourceCheckout, "the README must retain a fenced source-checkout sequence");+ assert.deepEqual(+ sourceCheckout[1].split(/\r?\n/),+ [+ "git clone https://github.com/socai-io/jev-social.git",+ "cd jev-social",+ "npm install",+ "npm start -- onboard",+ "npm start",+ ],+ );+ assert.match(readme, /On Linux,[^.]+(?:PATH|SOCAI_BIN)[^.]+onboarding\./);+ assert.doesNotMatch(+ readme,+ /https?:\/\/(?:www\.)?github\.com\/socai-io\/socai(?:\.git)?(?=$|[\s/?#)"'<])/i,+ );+ assert.doesNotMatch(readme, /https:\/\/(?:www\.)?socai\.io/);+ assert.doesNotMatch(readme, /(?:star|visit|try|explore|check out) (?:the )?socai\b/i);+ assert.doesNotMatch(readme, /(?:call|run|use|install|download) (?:the )?socai(?: CLI)? directly/i);+ assert.doesNotMatch(readme, /^socai\s+(?:instagram|tiktok|linkedin)\s+/im);+});+test("the social research guide is shipped with exact platform and safety boundaries", async () => {const [guide, sitemap, workflow, llms] = await Promise.all([readFile(new URL("../site/social-research/index.html", import.meta.url), "utf8"),