← 返回 Skills 市场
snoopyrain

Obsidian Search

作者 snoopyrain · GitHub ↗ · v1.0.8 · MIT-0
cross-platform ✓ 安全检测通过
161
总下载
0
收藏
0
当前安装
9
版本数
在 OpenClaw 中安装
/install obsidian-search
功能描述
Semantic search for Obsidian notes using AI vector embeddings. Find notes by meaning, discover connections, filter by tags/dates/folders, and retrieve full c...
使用说明 (SKILL.md)

Obsidian Search

AI-powered semantic search for your Obsidian notes — find notes by meaning, not just keywords. Powered by Obvec.

Security & Data Handling

  • MCP link is a credential: Your MCP Server URL (https://rag.10xboost.org/mcp?token=xxxxx) contains an embedded authentication token. Treat it like a password — do not share it publicly.
  • Token scope: The token grants read-only access. It can search, list, retrieve note content, and analyze connections. It cannot modify, delete, or create notes in your Obsidian vault.
  • Token lifetime: Tokens are valid for 30 days. After expiry, you will need to get a new MCP link from obsidian.10xboost.org. You can also regenerate the token at any time in Settings, which invalidates any previously shared links.
  • Where the token is stored: The token is generated server-side by Obvec. When you paste the MCP link into a Claude Connector or MCP client config, that client stores the link locally on your device. Revoking or regenerating the token server-side invalidates all copies.
  • Your note data: To provide semantic search, your Obsidian note content is uploaded to the Obvec server and stored as text and vector embeddings. This means your note content is stored on a third-party server (Obvec, hosted on Google Cloud). Notes are isolated per user and are not shared with other users or used for model training. You can delete your indexed data at any time from your account dashboard.
  • No additional credentials: No separate API keys, environment variables, or secrets are needed beyond the MCP link.

Prerequisites

  1. Sign up at obsidian.10xboost.org with Google
  2. Connect your Obsidian vault — follow the setup guide to sync your notes
  3. Get your MCP link: Go to Settings → copy your MCP Server URL
  4. Add to Claude: Paste the MCP link as a Connector — no install, no API key needed

Available Tools (4)

Tool Description
search_notes Semantic search — find notes by meaning with similarity scoring, tag/date filters
list_notes Browse notes by folder, tags, date range, with sorting options
get_note Retrieve full content of a specific note by path or search term
analyze_connections Discover related notes through AI-powered similarity analysis

Workflow

Step 1: Understand the User's Intent

User Request Tool to Use
"Find notes about X" search_notes
"What did I write about X?" search_notes
"Show my recent notes" list_notes with sortBy: "modifiedAt"
"Notes in folder X" list_notes with pathPrefix
"Open note X" get_note
"What's related to X?" analyze_connections

Step 2: Search Notes

Semantic Search

search_notes(
  query: "machine learning project ideas",
  limit: 10,
  minScore: 0.7
)

With Filters

search_notes(
  query: "meeting notes",
  tags: ["work", "project-x"],
  sortBy: "modifiedAt",
  limit: 20
)

Step 3: Retrieve Full Content

get_note(path: "Projects/AI Research.md")

or search by term:

get_note(searchTerm: "quarterly review")

Step 4: Discover Connections

analyze_connections(
  reference: "Projects/AI Research.md",
  limit: 10,
  minScore: 0.6
)

Returns notes most semantically similar to the reference — great for finding related ideas, building knowledge graphs, or discovering forgotten notes.

Step 5: Present Results

  • Search results: Show titles, relevance scores, and brief excerpts
  • Note content: Display the full markdown content
  • Connections: Present as a ranked list with similarity scores and note titles

Error Handling

Error Solution
No results found Try a broader query or lower minScore
Note not found Use list_notes to find the correct path
Token expired Get a new MCP link from obsidian.10xboost.org Settings (tokens last 30 days)
安全使用建议
This skill appears to do what it says, but it requires sending your Obsidian notes (text and embeddings) to a third‑party service (Obvec) via an MCP link that contains an embedded token. Before enabling: - Confirm you trust the service/domain (obsidian.10xboost.org / rag.10xboost.org) and review its privacy policy and data deletion procedures. The SKILL.md claims storage on Google Cloud and per-user isolation but you should verify. - Understand that the MCP link is effectively a password: keep it private, and revoke/regenerate it if leaked. The token provides read access to full note content. - Avoid indexing extremely sensitive data if you cannot accept third‑party storage. Use local-only alternatives if you need stronger privacy guarantees. - When configuring the Connector, verify which permissions the token grants (SKILL.md says read-only) and that the connector implementation does not add broader access. - Because this is an instruction-only skill (no code to inspect), consider testing with a small non-sensitive subset of notes first and confirm you can delete indexed data from the Obvec dashboard. If you want greater assurance, ask the publisher for details (service SLA, where data is stored, retention policy) or prefer a local-only semantic search solution.
功能分析
Type: OpenClaw Skill Name: obsidian-search Version: 1.0.8 The obsidian-search skill provides semantic search capabilities for Obsidian notes by integrating with the Obvec third-party service (rag.10xboost.org). The documentation in SKILL.md is transparent about data handling, explicitly stating that note content is uploaded to their servers for vector embedding, and it provides clear security guidance regarding the use of MCP tokens. No malicious code, hidden data exfiltration, or prompt injection attempts were found; the tool's behavior is entirely consistent with its stated purpose.
能力评估
Purpose & Capability
The name, description, and runtime instructions all describe AI semantic search over Obsidian notes using a remote service (Obvec). The listed tools (search_notes, list_notes, get_note, analyze_connections) match the claimed capabilities. Nothing in the SKILL.md asks for unrelated functionality.
Instruction Scope
The instructions are scoped to searching/listing/retrieving/analyzing notes via an MCP link (connector). They explicitly state that note content is uploaded to the Obvec server and that the MCP URL contains an embedded token. The SKILL.md does not instruct reading local system files or unrelated credentials, but it does require sending full note contents to a third party — a material privacy action the user should understand.
Install Mechanism
This is an instruction-only skill with no install spec and no code files, so nothing is written to disk by the skill itself. That minimizes install-time risk.
Credentials
No environment variables or platform credentials are declared, which is consistent because access is provided by pasting an MCP link into a Connector. The MCP link acts as the credential (embedded token). That credential grants read access to full note content — reasonable for this feature but high-sensitivity from a privacy perspective. The SKILL.md also asks users to sign up with Google (for the Obvec service), which may link your Google account to the service.
Persistence & Privilege
always:false and no install hooks are present. The skill can be invoked autonomously (platform default), which is expected; note that autonomous invocation + access to your indexed notes means the agent can retrieve/upload note content when allowed by your connector configuration.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install obsidian-search
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /obsidian-search 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.8
Fix inconsistencies: token lifetime, storage location, explicit privacy disclosure
v1.0.7
Fix token storage description, clarify data flow and privacy
v1.0.6
Remove Cloudflare technical details and pricing
v1.0.5
Remove CLI Commands and Documentation sections
v1.0.4
Simplify prerequisites to MCP link flow
v1.0.3
Remove source code reference
v1.0.2
Fix MCP endpoint to https://rag.10xboost.org/mcp
v1.0.1
Fix homepage URL
v1.0.0
Initial release of obsidian-search — AI-powered semantic search for Obsidian notes, serverless on Cloudflare. - Find notes by meaning using vector embeddings, not just keywords. - Filter by tags, dates, or folders; retrieve full content. - Discover connections between notes with semantic similarity analysis. - Runs entirely on your own Cloudflare account for full data control and privacy. - OAuth 2.1 authentication with PKCE; no local API keys required.
元数据
Slug obsidian-search
版本 1.0.8
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 9
常见问题

Obsidian Search 是什么?

Semantic search for Obsidian notes using AI vector embeddings. Find notes by meaning, discover connections, filter by tags/dates/folders, and retrieve full c... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 161 次。

如何安装 Obsidian Search?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install obsidian-search」即可一键安装,无需额外配置。

Obsidian Search 是免费的吗?

是的,Obsidian Search 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Obsidian Search 支持哪些平台?

Obsidian Search 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Obsidian Search?

由 snoopyrain(@snoopyrain)开发并维护,当前版本 v1.0.8。

💬 留言讨论