← Back to Skills Marketplace
winterw

Ok Core Skill

by WinterW · GitHub ↗ · v0.0.5 · MIT-0
darwinlinux ⚠ suspicious
204
Downloads
1
Stars
0
Active Installs
5
Versions
Install in OpenClaw
/install ok-core-skills
Description
OK Skills — automate OK.com, a global classifieds and marketplace platform. Search listings, browse categories, view listing details, manage favorites, and m...
Usage Guidance
This skill appears to implement exactly what it claims (an OK.com automation tool), but it requires broad local browser access and makes filesystem/process changes that you should consider before installing. Things to review/consider before installing or running: - Inspect and load the Chrome extension only from a trusted source; the extension has permissions to read cookies for ok.com, run scripts in pages, use the debugger API, and capture screenshots. - The Python client may auto-launch Chrome with a persistent profile under ~/.ok-agent, write a chrome.pid file, and may kill previously auto-launched Chrome processes — if you don't want profile changes or process control, set OK_NO_AUTO_LAUNCH or run in an isolated environment. - The bridge/extension architecture opens a localhost WebSocket (ws://localhost:9334) to accept commands; running the bridge server and connecting the extension allows the CLI to execute arbitrary JS in browser pages (needed for scraping/automation but high risk). - The code can set file inputs (upload local files) via the debugger API — do not run the CLI while sensitive files are present unless you trust the code and its inputs. - If you plan to use it, prefer: an isolated Chrome profile, a throwaway OK.com account or non-sensitive data for testing, and review the full repo files (especially omitted files) and the Python dependencies (playwright-stealth) before granting permissions. Confidence is medium because the package is internally coherent for its stated purpose, but the combination of high-privilege browser capabilities and filesystem/process control warrants caution and manual review prior to use.
Capability Tags
cryptorequires-oauth-tokenrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
Name/description (OK.com automation) align with the included files: a browser extension (OK Bridge), a local bridge server, Python CLI and clients (Playwright/CDP/bridge). Required binaries (python3, uv) are consistent with the CLI usage described.
Instruction Scope
SKILL.md instructs use of 'uv run --project <SKILL_DIR> ok-cli ...', bridge vs Playwright modes, and to read sub-skill SKILL.md files. It does not explicitly document side-effects present in the code: creating ~/.ok-agent, writing a chrome.pid file, auto-launching Chrome with a custom profile, or requiring installation of a Chrome extension with broad permissions. The runtime can execute arbitrary JS in the page context (via Function constructor in the extension) which is expected for an automation tool but is a high-privilege capability and should be disclosed.
Install Mechanism
There is no remote download/install spec — code and pyproject are included. Dependencies are standard PyPI packages (requests, websockets, playwright, playwright-stealth). No external URLs or archive downloads were specified in the install metadata.
Credentials
The skill declares no required environment variables, which is consistent. However the runtime supports and uses optional env vars (OK_CDP_URL, OK_NO_AUTO_LAUNCH, OK_HEADLESS, etc.) and will create ~/.ok-agent and a persistent Chrome profile. The extension and bridge can read cookies for ok.com and the CLI can call get_cookies — access to local browser data is proportional to login/automation features but is sensitive and not highlighted in the top-level SKILL.md.
Persistence & Privilege
always:false (good). But the code will create ~/.ok-agent, write a PID file, may auto-launch and later kill Chrome instances, and attempts to reuse or manage a persistent Chrome profile. The Chrome extension requires 'cookies', 'debugger', 'scripting' and can execute arbitrary code in page MAIN world and set file input values via CDP — these are high-privilege browser capabilities and represent a meaningful persistence/privilege footprint on the user's machine.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ok-core-skills
  3. After installation, invoke the skill by name or use /ok-core-skills
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.0.5
- Improved search functionality in scripts/ok/full_search.py - Updated route handling in scripts/ok/urls.py
v0.0.4
- Expanded and clarified the skill description in SKILL.md, adding English explanations, feature summaries, supported use-cases, and alias names. - Listed all 10 supported countries, key feature highlights, and typical user prompts in the description for improved discoverability and clarity. - No changes to technical constraints, interface, or subskill logic.
v0.0.3
- Added a new file: skills/ok-account/SKILL.md. - 收藏管理和我的帖子相关操作统一改为先读取 ok-account 子技能文档并按步骤执行,需检查登录。 - 输入判断流程中,收藏和我的帖子操作调整为需依赖 skills/ok-account/SKILL.md。 - Favorites 和 My Posts 子技能说明已合并为 ok-account,原有相关命令从主文档移除。 - 增强子技能职责边界,使账户相关操作更集中、更易于维护。
v0.0.2
Initial implementation of core skills for ok-core-skills: - Added 32 core files supporting automation logic (Python .pyc cache files) for command execution. - Core modules cover country/city management, category browsing, search, login, favorites, and post management. - Prepared CLI interface and logic to enable skill routing, favorites, locale switch, and feed handling. - Supports both Bridge (Chrome extension) and Playwright (headless browser) modes for flexibility.
v0.0.1
- Initial release of the OK.com automation skill collection. - Supports multi-country/city/language switching, post search, category browsing, detail retrieval, favorites management, and personal post management. - Unified CLI operations using uv and ok-cli, with detailed execution and input routing rules. - Two operation modes: Bridge (with Chrome extension) and Playwright (headless browser fallback). - Comprehensive input intent parsing and strict routing to sub-skills based on user requests. - Structured JSON output for all CLI operations and enforced execution constraints.
Metadata
Slug ok-core-skills
Version 0.0.5
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 5
Frequently Asked Questions

What is Ok Core Skill?

OK Skills — automate OK.com, a global classifieds and marketplace platform. Search listings, browse categories, view listing details, manage favorites, and m... It is an AI Agent Skill for Claude Code / OpenClaw, with 204 downloads so far.

How do I install Ok Core Skill?

Run "/install ok-core-skills" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Ok Core Skill free?

Yes, Ok Core Skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Ok Core Skill support?

Ok Core Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).

Who created Ok Core Skill?

It is built and maintained by WinterW (@winterw); the current version is v0.0.5.

💬 Comments