← Back to Skills Marketplace
garrrikkotua

Octolens

by garrrikkotua · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
2702
Downloads
4
Stars
7
Active Installs
1
Versions
Install in OpenClaw
/install octolens
Description
Query and analyze brand mentions from Octolens API. Use when the user wants to fetch mentions, track keywords, filter by source platforms (Twitter, Reddit, GitHub, LinkedIn, etc.), sentiment analysis, or analyze social media engagement. Supports complex filtering with AND/OR logic, date ranges, follower counts, and bookmarks.
Usage Guidance
The skill's code matches its description — it only queries https://app.octolens.com/api/v1 and prints results — but the package metadata failing to declare the required API credential is a red flag. Before installing: - Verify the Octolens service and domain (app.octolens.com) are legitimate and that you trust the publisher (no homepage or known owner is listed). - Provide an API key only when necessary and consider creating a key with limited scope/permissions and an expiration if the service supports it. - Prefer passing the API key as a command-line argument or ephemeral prompt rather than storing it permanently in agent config; confirm how your agent stores secrets. - Review the included scripts yourself (they are short and readable) to confirm there are no hidden endpoints or telemetry; the provided files only contact the documented API. Because the metadata does not declare the required credential, treat this skill as suspicious until you confirm the publisher and how API keys will be handled/stored.
Capability Analysis
Type: OpenClaw Skill Name: octolens Version: 1.0.0 The skill bundle provides a legitimate client for the Octolens API. The `SKILL.md` instructions guide the AI agent on how to interact with the API, including handling API keys and constructing queries, without any evidence of prompt injection attempting to manipulate the agent into malicious behavior. The Node.js scripts (`scripts/*.js`) are straightforward API clients, making requests only to the documented `https://app.octolens.com/api/v1` endpoint, and do not attempt to access sensitive local files, exfiltrate data, or execute arbitrary code. The `allowed-tools: Node Read` permission is appropriate for executing the bundled Node.js scripts.
Capability Assessment
Purpose & Capability
Name/description describe querying Octolens mentions. All included scripts (fetch-mentions, query-mentions, list-keywords, list-views, advanced-query) call https://app.octolens.com/api/v1 endpoints and implement the documented filter parameters — capabilities align with the stated purpose.
Instruction Scope
SKILL.md and bundled scripts limit actions to making authenticated HTTP requests to the Octolens API and printing results. There are no instructions to read unrelated files, access other system configuration, or post data to unexpected endpoints.
Install Mechanism
There is no install spec. The skill is instruction-only with bundled Node.js scripts; nothing in the manifest pulls remote archives or executes installers. This is low install risk.
Credentials
The runtime clearly requires an Octolens API key (SKILL.md: 'Always ask the user for their API key' and all scripts accept an API key argument), but the registry metadata lists no required environment variables or primary credential. That mismatch between declared metadata and the actual authentication requirement is an incoherence and reduces trust. Additionally, the skill publisher and homepage are unknown, so you cannot easily verify the API owner or permission scopes for keys you provide.
Persistence & Privilege
The skill does not request persistent/always-on privileges and does not modify system-wide settings. It runs as-needed and requires user-supplied API keys at runtime (via arguments or prompts).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install octolens
  3. After installation, invoke the skill by name or use /octolens
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Octolens 1.0.0 – Initial Release - Query and analyze brand mentions from the Octolens API across platforms like Twitter, Reddit, GitHub, LinkedIn, and more. - Filter mentions by source, sentiment, follower count, engagement, date range, tags, and complex AND/OR logic. - Support for keyword tracking, bookmarks, and advanced filtering (including exclusions). - List available keywords and saved views for streamlined queries. - Includes ready-to-use Node.js scripts for common API operations and custom queries. - Requires user-supplied API key (Bearer token) for authentication.
Metadata
Slug octolens
Version 1.0.0
License
All-time Installs 7
Active Installs 7
Total Versions 1
Frequently Asked Questions

What is Octolens?

Query and analyze brand mentions from Octolens API. Use when the user wants to fetch mentions, track keywords, filter by source platforms (Twitter, Reddit, GitHub, LinkedIn, etc.), sentiment analysis, or analyze social media engagement. Supports complex filtering with AND/OR logic, date ranges, follower counts, and bookmarks. It is an AI Agent Skill for Claude Code / OpenClaw, with 2702 downloads so far.

How do I install Octolens?

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

Is Octolens free?

Yes, Octolens is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Octolens support?

Octolens is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Octolens?

It is built and maintained by garrrikkotua (@garrrikkotua); the current version is v1.0.0.

💬 Comments