← Back to Skills Marketplace
Finnhub Skill
by
keyfrog-21K
· GitHub ↗
· v1.0.0
2036
Downloads
3
Stars
4
Active Installs
1
Versions
Install in OpenClaw
/install openclaw-finnhub
Description
Provides real-time US stock quotes and financial data using the Finnhub API and Python.
Usage Guidance
This skill appears to do what it says: call Finnhub for stock quotes. Before installing: (1) Be aware the registry metadata omits the required environment variable — you must set finnhub_api_key in the agent environment. (2) The skill's source/homepage is unknown; prefer skills with a verifiable repository or publisher. (3) The included script has a small bug (it passes a list instead of a string and has fragile argv checks); you may want to review/fix scripts/app.py before running. (4) Only provide your Finnhub API key if you trust the skill publisher; keep keys scoped and rotate them if exposed. (5) If you need stronger assurance, request the skill's upstream source or a checksum of the code before using it in production.
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-finnhub
Version: 1.0.0
The skill bundle is benign. It provides a Python script (`scripts/app.py`) to fetch real-time stock quotes using the Finnhub API. The script securely retrieves the Finnhub API key from an environment variable (`finnhub_api_key`), which is a standard practice. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, prompt injection attempts in `SKILL.md`, or obfuscation. All actions are clearly aligned with the stated purpose of accessing Finnhub data.
Capability Assessment
Purpose & Capability
The SKILL.md and scripts/app.py describe fetching real-time quotes from Finnhub and require a Finnhub API key — that is coherent with the stated purpose. However, the registry metadata lists no required environment variables while SKILL.md requires finnhub_api_key, and the skill has no published homepage/source (source=unknown). This is likely a packaging/metadata omission but is inconsistent.
Instruction Scope
Runtime instructions are narrowly scoped to installing finnhub-python, setting finnhub_api_key, and running scripts/app.py. The code only initializes the Finnhub client and calls the quote API. There is a bug in scripts/app.py: main passes a list to get_quote (get_quote([sys.argv[2]])) while get_quote expects a string, and the argv indexing/checks are sloppy; this can cause runtime errors but is not evidence of malicious behavior.
Install Mechanism
There is no install spec (instruction-only), which is low-risk. SKILL.md suggests installing the finnhub-python pip package; this is standard for Python integrations. No downloads from untrusted URLs or archive extraction are present.
Credentials
The only secret the skill needs is the Finnhub API key (finnhub_api_key), which is appropriate for a Finnhub integration. The inconsistency is that the registry metadata does not declare this required env var; SKILL.md and the script do. No other credentials or system config are requested.
Persistence & Privilege
The skill does not request always:true and does not claim persistent system-wide privileges. It does not modify other skills' configurations or require elevated access.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-finnhub - After installation, invoke the skill by name or use
/openclaw-finnhub - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of OpenClaw-Finnhub: real-time stock quotes and financials via Finnhub API.
- Provides real-time US stock quote data using Finnhub API.
- Includes a script (`./scripts/app.py`) to fetch and display stock information.
- Requires Python 3.11+, the `finnhub-python` package, and a Finnhub API key set in the environment.
Metadata
Frequently Asked Questions
What is Finnhub Skill?
Provides real-time US stock quotes and financial data using the Finnhub API and Python. It is an AI Agent Skill for Claude Code / OpenClaw, with 2036 downloads so far.
How do I install Finnhub Skill?
Run "/install openclaw-finnhub" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Finnhub Skill free?
Yes, Finnhub Skill is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Finnhub Skill support?
Finnhub Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Finnhub Skill?
It is built and maintained by keyfrog-21K (@keyfrog-21k); the current version is v1.0.0.
More Skills