← 返回 Skills 市场
290
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install skroller
功能描述
Automate scraping and filtering of public social media posts with keyword search, engagement filters, deduplication, and export to JSON, CSV, or notes apps.
安全使用建议
What to consider before installing/using this skill:
- Missing declared secrets: The registry lists no required env vars, but the code expects values such as NOTION_API_KEY / NOTION_TOKEN and MS_TOKEN for exports; confirm which credentials you'll need and avoid supplying high-privilege tokens. Prefer creating a dedicated, limited-scope API key for Notion/OneDrive if you use those features.
- Filesystem writes: The tool writes files (e.g., .skroller-seen.json, cookies.json) and creates notes in your specified vault/folders. Run in an isolated directory or VM to avoid accidental contamination of your primary workspace.
- Anti‑bot / evasion guidance: The docs explicitly recommend proxy rotation, residential proxy services, user-agent rotation, and mouse simulation. Those are techniques that can be used to evade platform detection and may violate target platforms' Terms of Service — do not use them to bypass access controls or for abusive purposes.
- Shell execution: export-to-notes uses child_process.execSync (invoking 'grizzly' CLI and constructing shell commands). If you pass untrusted input into filenames, note titles, or tags, it could result in command injection. Audit how filenames/titles are constructed before running with untrusted data.
- Legal/ToS risk: The author repeatedly notes ToS and privacy obligations, but that is not a guarantee. Scraping certain platforms (LinkedIn, Twitter/X, Instagram) may violate their Terms; consult legal counsel if this is for commercial use or large‑scale collection.
- Recommended actions before running:
- Inspect the scripts (you already have them) and search for any references to environment variables or remote endpoints you do not expect.
- Run npm install and test in a sandboxed environment (container/VM) first.
- Use low-volume, conservative settings, and prefer official APIs where available.
- If exporting to third‑party services, create limited-scope API tokens and avoid using personal or organization-wide tokens.
- Consider removing or hardening anti-evasion/proxy code if you intend to remain strictly within platform policies.
If you want, I can list every environment variable and external dependency the code references and point to the exact lines where they appear.
功能分析
Type: OpenClaw Skill
Name: skroller
Version: 0.0.1
The skill bundle provides a comprehensive framework for social media scraping and data export to various note-taking applications. However, it contains significant security vulnerabilities in `scripts/export-to-notes.js`, where unsanitized data from scraped posts is passed into `execSync` calls for `osascript` (Apple Notes) and `grizzly` (Bear notes), creating a high risk of shell injection. While these appear to be unintentional coding flaws rather than intentional malware, they allow for potential remote code execution if the agent scrapes specially crafted malicious content from social media platforms.
能力评估
Purpose & Capability
The name/description match the code and docs: Playwright-based browser automation across many social platforms, filtering/deduplication, digest generation, and export to note apps. The declared dependencies (playwright in package.json) and included scripts align with the stated purpose.
Instruction Scope
SKILL.md and the scripts instruct the agent to perform broad browser automation, login when needed, persist cookies, write a seen-posts file, and call external services (Notion API, grizzly CLI). The docs also include explicit anti-bot/evading techniques (user-agent rotation, proxy rotation, human mouse simulation, residential proxy vendors) that go beyond benign automation recommendations and may facilitate bypassing platform protections. The skill reads/writes local files (.skroller-seen.json, cookies.json, and note vaults) and sends data to external endpoints (Notion API) — these are within scope for export but should have been declared.
Install Mechanism
The registry entry provides no install spec, but package.json lists Playwright (a large dependency) meaning users will need to run npm install to use it. There are no suspicious external download URLs; all code is included. The absence of an explicit install/install-time instructions in the registry is notable (user will need to install Node >=18 and run npm install), but not inherently malicious.
Credentials
The skill's metadata declares no required environment variables, yet the SKILL.md and scripts reference/expect secrets and external credentials (e.g., NOTION_API_KEY / NOTION_TOKEN, MS_TOKEN, and possibly others for note APIs). Exports use process.env.NOTION_API_KEY and command examples show $MS_TOKEN. Those credentials are reasonable for the export features, but they should have been declared in requires.env/primaryEnv. The exporter also runs shell commands (execSync) which increases the impact of any supplied tokens or untrusted content. Overall, requested/used environment access is underdeclared and therefore disproportionate to the registry metadata.
Persistence & Privilege
The skill does not request always: true and does not modify other skills. It writes local files (seen posts file, cookies.json, creates notes in user-specified vaults and paths) and may create notes via external services (Notion). Writing to the user's filesystem and storing cookies/seen-posts is expected for a scraper but is persistent behavior the user should be aware of.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install skroller - 安装完成后,直接呼叫该 Skill 的名称或使用
/skroller触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.0.1
Initial release of skroller - automate social media content collection and analysis across major platforms.
- Supports scraping and analyzing public posts from 10+ social media platforms (Twitter/X, Instagram, TikTok, Reddit, LinkedIn, YouTube, Product Hunt, Medium, GitHub, and Pinterest).
- Exports data in JSON, CSV, Markdown, or directly to 10+ note apps (Notion, Apple Notes, Evernote, OneNote, Google Keep, Bear, and Obsidian).
- Enables filtering by keywords, hashtags, engagement, dates, and more; includes deduplication.
- Includes scripts for scrolling, digest generation, and unified export to note-taking platforms.
- Comes with robust compliance guidance for privacy laws, platform ToS, and data protection.
- Highly configurable via `.skroller-config.json` and supports authentication where needed.
元数据
常见问题
skroller 是什么?
Automate scraping and filtering of public social media posts with keyword search, engagement filters, deduplication, and export to JSON, CSV, or notes apps. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 290 次。
如何安装 skroller?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install skroller」即可一键安装,无需额外配置。
skroller 是免费的吗?
是的,skroller 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
skroller 支持哪些平台?
skroller 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 skroller?
由 X(@10oss)开发并维护,当前版本 v0.0.1。
推荐 Skills