findinflu

CLI and Node.js API for scraping TikTok video metadata and Google keyword search results.

Scraping depends on third-party websites. Results may change or fail when TikTok or Google changes pages, blocks automation, shows consent screens, or requires captcha/login. Use responsibly and follow applicable terms, rate limits, privacy rules, and laws.

English

Requirements

• Node.js >=18
• npm
• A machine/server that can launch Chromium

Installation

npm install @buildifyx/findinflu

You can also run the CLI with npx:

npx @buildifyx/findinflu --help

Run the latest CLI without global installation:

npx @buildifyx/findinflu@latest --help

CLI Usage

findinflu scrape <platform> <url|keyword> [-m method] [-p page]

Show installed version:

npx @buildifyx/findinflu -v

You can also use:

npx @buildifyx/findinflu --version
npx @buildifyx/findinflu -version

Scrape a TikTok video:

npx @buildifyx/findinflu scrape tiktok "https://www.tiktok.com/@user/video/1234567890123456789"

Scrape a TikTok video with method name:

npx @buildifyx/findinflu scrape tiktok "https://www.tiktok.com/@user/video/1234567890123456789" -m video

Scrape Google keyword results:

npx @buildifyx/findinflu scrape google "openai news" -p 1 -m keyword

Use the latest published version without installing globally:

npx @buildifyx/findinflu@latest scrape google "openai news" -p 1 -m keyword

CLI Options

| Option | Alias | Description | | --- | --- | --- | | -v | --version, -version | Show findinflu version. | | -m <name> | --method <name> | Select scraper method. | | -e <name> | --engine <name> | Alias for --method. | | -p <number> | --page <number> | Google result page. Default is 1. |

Supported Platforms

| Platform | Method | Input | Output | | --- | --- | --- | --- | | tiktok | video | TikTok video URL | Video description, author info, video stats, author stats. | | google | keyword | Search keyword | Result URL, domain, title, snippet, keyword, collected time. |

Node.js API

const { runScrape, TikTok, Google, listPlatforms } = require("@buildifyx/findinflu");

Use the generic runner:

const { runScrape } = require("@buildifyx/findinflu");

async function main() {
  const result = await runScrape({
    platform: "tiktok",
    url: "https://www.tiktok.com/@user/video/1234567890123456789",
    method: "video",
  });

  console.log(result);
}

main().catch(console.error);

Google keyword example:

const { runScrape } = require("@buildifyx/findinflu");

async function main() {
  const results = await runScrape({
    platform: "google",
    url: "openai news",
    method: "keyword",
    page: 1,
  });

  console.log(results);
}

main().catch(console.error);

Use platform APIs directly:

const { TikTok, Google } = require("@buildifyx/findinflu");

async function main() {
  const video = await TikTok.video(
    "https://www.tiktok.com/@user/video/1234567890123456789",
  );

  const keywords = await Google.keyword("openai news", { page: 1 });

  console.log({ video, keywords });
}

main().catch(console.error);

List available platforms:

const { listPlatforms } = require("@buildifyx/findinflu");

console.log(listPlatforms());

Example:

{
  "google": ["keyword"],
  "tiktok": ["video"]
}

Output Examples

TikTok video:

{
  "success": true,
  "data": {
    "desc": "Video description",
    "author": {
      "id": "123456789",
      "uniqueId": "creator",
      "nickname": "Creator Name",
      "verified": false,
      "signature": "Profile bio",
      "avatar": "https://..."
    },
    "status": {
      "diggCount": 100,
      "shareCount": 10,
      "commentCount": 5,
      "playCount": 1000
    },
    "authorStats": {
      "followerCount": 10000,
      "followingCount": 100,
      "heartCount": 50000,
      "videoCount": 50
    }
  }
}

TikTok video not found:

{
  "success": false,
  "data": null
}

Google keyword:

[
  {
    "query_keyword": "openai news",
    "url": "https://example.com/article",
    "domain": "example.com",
    "title": "Example Search Result",
    "snippet": "Short result snippet from Google.",
    "collected_at": "2026-04-29T00:00:00.000Z"
  }
]

Browser Configuration

For TikTok scraping, you can set a custom Chromium/Chrome executable:

PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium npx @buildifyx/findinflu scrape tiktok "https://www.tiktok.com/@user/video/1234567890123456789"

This is useful on Docker, CI, and servers where Chromium is installed separately.

Common Errors

• Platform not supported: unsupported platform name.
• Method not found: unsupported method for the selected platform.
• Invalid URL: the scraper requires an HTTP or HTTPS URL.
• Google did not return search results: Google may have returned a consent page, block page, captcha, unusual page, or changed markup.
• Browser launch failure: Chromium is missing or required system libraries are unavailable.

ภาษาไทย

สิ่งที่ต้องมี

• Node.js >=18
• npm
• เครื่องหรือเซิร์ฟเวอร์ที่เปิด Chromium ได้

ติดตั้ง

npm install @buildifyx/findinflu

หรือใช้งาน CLI ผ่าน npx:

npx @buildifyx/findinflu --help

ใช้ CLI เวอร์ชันล่าสุดโดยไม่ต้องติดตั้งแบบ global:

npx @buildifyx/findinflu@latest --help

วิธีใช้ CLI

findinflu scrape <platform> <url|keyword> [-m method] [-p page]

ดูเวอร์ชันที่ใช้งานอยู่:

npx @buildifyx/findinflu -v

ใช้แบบนี้ได้เช่นกัน:

npx @buildifyx/findinflu --version
npx @buildifyx/findinflu -version

ดึงข้อมูลวิดีโอ TikTok:

npx @buildifyx/findinflu scrape tiktok "https://www.tiktok.com/@user/video/1234567890123456789"

ดึงข้อมูลวิดีโอ TikTok โดยระบุ method:

npx @buildifyx/findinflu scrape tiktok "https://www.tiktok.com/@user/video/1234567890123456789" -m video

ดึงผลลัพธ์ Google keyword:

npx @buildifyx/findinflu scrape google "openai news" -p 1 -m keyword

ใช้เวอร์ชันล่าสุดจาก npm โดยไม่ต้อง npm i -g @buildifyx/findinflu:

npx @buildifyx/findinflu@latest scrape google "openai news" -p 1 -m keyword

ตัวเลือก CLI

| Option | Alias | รายละเอียด | | --- | --- | --- | | -v | --version, -version | แสดงเวอร์ชันของ findinflu | | -m <name> | --method <name> | เลือก method ของ scraper | | -e <name> | --engine <name> | alias ของ --method | | -p <number> | --page <number> | หน้าผลลัพธ์ Google ค่าเริ่มต้นคือ 1 |

Platform ที่รองรับ

| Platform | Method | Input | Output | | --- | --- | --- | --- | | tiktok | video | URL วิดีโอ TikTok | description, ข้อมูลผู้สร้าง, สถิติวิดีโอ, สถิติผู้สร้าง | | google | keyword | คำค้นหา | URL, domain, title, snippet, keyword, เวลาที่เก็บข้อมูล |

วิธีใช้ Node.js API

const { runScrape, TikTok, Google, listPlatforms } = require("@buildifyx/findinflu");

ใช้ generic runner:

const { runScrape } = require("@buildifyx/findinflu");

async function main() {
  const result = await runScrape({
    platform: "tiktok",
    url: "https://www.tiktok.com/@user/video/1234567890123456789",
    method: "video",
  });

  console.log(result);
}

main().catch(console.error);

ตัวอย่าง Google keyword:

const { runScrape } = require("@buildifyx/findinflu");

async function main() {
  const results = await runScrape({
    platform: "google",
    url: "openai news",
    method: "keyword",
    page: 1,
  });

  console.log(results);
}

main().catch(console.error);

ใช้ API ของแต่ละ platform:

const { TikTok, Google } = require("@buildifyx/findinflu");

async function main() {
  const video = await TikTok.video(
    "https://www.tiktok.com/@user/video/1234567890123456789",
  );

  const keywords = await Google.keyword("openai news", { page: 1 });

  console.log({ video, keywords });
}

main().catch(console.error);

ดู platform ที่ใช้งานได้:

const { listPlatforms } = require("@buildifyx/findinflu");

console.log(listPlatforms());

ตัวอย่าง:

{
  "google": ["keyword"],
  "tiktok": ["video"]
}

ตัวอย่าง Output

TikTok video:

{
  "success": true,
  "data": {
    "desc": "Video description",
    "author": {
      "id": "123456789",
      "uniqueId": "creator",
      "nickname": "Creator Name",
      "verified": false,
      "signature": "Profile bio",
      "avatar": "https://..."
    },
    "status": {
      "diggCount": 100,
      "shareCount": 10,
      "commentCount": 5,
      "playCount": 1000
    },
    "authorStats": {
      "followerCount": 10000,
      "followingCount": 100,
      "heartCount": 50000,
      "videoCount": 50
    }
  }
}

กรณีไม่พบข้อมูลวิดีโอ TikTok:

{
  "success": false,
  "data": null
}

Google keyword:

[
  {
    "query_keyword": "openai news",
    "url": "https://example.com/article",
    "domain": "example.com",
    "title": "Example Search Result",
    "snippet": "Short result snippet from Google.",
    "collected_at": "2026-04-29T00:00:00.000Z"
  }
]

ตั้งค่า Browser

สำหรับ TikTok scraper สามารถกำหนด path ของ Chromium/Chrome เองได้:

PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium npx @buildifyx/findinflu scrape tiktok "https://www.tiktok.com/@user/video/1234567890123456789"

เหมาะกับ Docker, CI หรือ server ที่ติดตั้ง Chromium แยกไว้แล้ว

Error ที่พบบ่อย

• Platform not supported: platform ที่ระบุยังไม่รองรับ
• Method not found: method ที่ระบุไม่มีใน platform นั้น
• Invalid URL: scraper ต้องการ URL แบบ HTTP หรือ HTTPS
• Google did not return search results: Google อาจแสดง consent page, block page, captcha, หน้าแปลก หรือ markup เปลี่ยน
• Browser launch failure: ไม่มี Chromium หรือ system libraries ไม่ครบ

License

MIT