Skip to main content

Forums & Documents Components

Pull external knowledge into your definition from community forums (SmartHopper → E. Forums) and local files or web pages (SmartHopper → F. Documents).

Knowledge components

Forums (E. Forums)​

SmartHopper includes dedicated components for the McNeel Discourse forum, the Ladybug Tools forum, and any Discourse forum (by passing its Base URL):

ActionIconComponents (Nickname)Preview
Search postsMcNeelForum Search icon LadybugForum Search icon Discourse Search iconMcNeelForum Search (McNeelSearch), LadybugForum Search (LadybugSearch), Discourse Search (DiscourseSearch) — search by Query and output matching post JSON objects.mcneel-forum-search ladybug-forum-search discourse-search
Fetch a full postMcNeelForum Post Get icon LadybugForum Post Get icon Discourse Post Get iconMcNeelForum Post Get (McNeelPostGet), LadybugForum Post Get (LadybugPostGet), Discourse Post Get (DiscoursePostGet) — fetch a full post JSON object by numeric Id.mcneel-forum-post-get ladybug-forum-post-get discourse-post-get
Open in browserMcNeelForum Post Open icon LadybugForum Post Open icon Discourse Post Open iconMcNeelForum Post Open (McNeelPostOpen), LadybugForum Post Open (LadybugPostOpen), Discourse Post Open (DiscoursePostOpen) — open a post JSON object in your default browser.mcneel-forum-post-open ladybug-forum-post-open discourse-post-open
Deconstruct post JSONDeconstruct Discourse Post iconDeconstruct Discourse Post (DeconstructDiscoursePost) — split any Discourse/McNeel/Ladybug post JSON into Id, Username, Topic Id, Topic Title, Post URL, Date, Content, Reads, and Likes.deconstruct-discourse-post
AI summarize postAI McNeelForum Post Summarize icon AI LadybugForum Post Summarize icon AI Discourse Post Summarize iconAI McNeelForum Post Summarize (AIMcNeelPostSumm), AI LadybugForum Post Summarize (AILadybugPostSumm), AI Discourse Post Summarize (AIDiscoursePostSumm) — summarize a single post by Post Id with optional focus Instructions.ai-mcneel-post-summarize ai-ladybug-post-summarize ai-discourse-post-summarize
AI summarize topicAI McNeelForum Topic Summarize icon AI LadybugForum Topic Summarize icon AI Discourse Topic Summarize iconAI McNeelForum Topic Summarize (AIMcNeelTopicSumm), AI LadybugForum Topic Summarize (AILadybugTopicSumm), AI Discourse Topic Summarize (AIDiscourseTopicSumm) — summarize an entire thread by Topic Id with optional focus Instructions.ai-mcneel-topic-summarize ai-ladybug-topic-summarize ai-discourse-topic-summarize

Typical workflow: Search posts by query → fetch a full post (or grab its Topic Id) → deconstruct the JSON into fields → open it in the browser for a quick look or summarize it with AI. The generic Discourse variants work on any forum — pass the forum's Base URL; the McNeel and Ladybug variants have it preconfigured. See the Search forums guide for a step-by-step canvas walkthrough.

Documents & web pages (F. Documents)​

IconComponentNicknameWhat it doesPreview
File To Markdown iconFile To MarkdownFile2MdConvert local files (PDF, DOCX, XLSX, PPTX, HTML, CSV, JSON, XML, TXT, EML, EPUB, RTF…) to Markdown and extract embedded Images locally — no AI provider required. Also outputs the detected Format and Rendered Pages (Pgs, PDF sources).file-to-markdown
Web To Markdown iconWeb To MarkdownWeb2MdFetch a URL and convert it to clean Markdown locally — no AI provider required. Includes dedicated extractors for Wikipedia/Wikimedia, GitHub/GitLab files, Discourse, and Stack Exchange, and respects robots.txt.web-to-markdown
AI File To Markdown iconAI File To MarkdownAIFile2MdSame local file conversion plus AI-generated visual evidence appended under labeled headings (requires an AI provider).ai-file-to-markdown
AI Web To Markdown iconAI Web To MarkdownAIWeb2MdSame web page conversion plus optional AI-powered image handling (Image Mode: link default, embed, describe, or caption).ai-web-to-markdown

Example​

Search, deconstruct, and summarize a forum post

See also: Search forums and Open files & convert web pages to Markdown.