firecrawl-research
This skill should be used when the user requests to research topics using FireCrawl, enrich notes with web sources, search and scrape information, or write scientific/academic papers. It extracts research topics from markdown files, creates research documents with scraped sources, generates BibTeX b
By glebis · 372 installs
npx skills add glebis/claude-skills --skill firecrawl-research
Source repository · Upstream listing
FireCrawl Research
Overview
Enrich research documents by automatically searching and scraping web sources using the FireCrawl API. Extract research topics from markdown files and generate comprehensive research documents with source material.
When to Use This Skill
Use this skill when the user:
Says "Research this topic using FireCrawl"
Requests to enrich notes or documents with web sources
Wants to gather information about topics listed in a markdown file
Needs to search and scrape multiple topics systematically
How It Works
1. Topic Extraction
The script automatically extracts research topics from markdown files using two methods:
Method 1: Headers
Both Spatial Reasoning in AI and Computer Vision Applications become research topics.
Method 2: Research Tags
Both tagged items become research topics.
2. Search and Scrape
For each topic:
1. Searches FireCrawl with the topic as query
2. Retrieves up to N results (default: 5)
3. Automatically scrapes full content from each result
4. Extracts markdown formatted content (main content only)
3. Output Generation
Creates new markdown files in the specified output directory:
One file per topic
Filename: {topic} {timestamp}.md
Contains: title, date, sources count, full scraped content
Each source includes: title, URL, markdown content
Usage
Basic Usage
Outputs to current directory.
Specify Output Directory
Creates files in ./output/ folder.
Limit Results Per Topic
Retrieves maximum 3 results per topic.
Configuration
API Key Setup
1. Copy .env.example to .env :
2. Add FireCrawl API key:
The script automatically loads the API key from the skill's .env file.
Rate Limiting
The script includes automatic rate limiting for FireCrawl's free tier:
Free tier limit: 5 requests/minute
Built in delay: 12 seconds between topics
Prevents API errors and credit exhaustion
When processing multiple topics, expect:
5 topics: ~1 minute
10 topics: ~2 minutes
20 topics: ~4 minutes
Workflow Example
User request: "Research these AI topics using FireCrawl"
Input file ( ai research.md ):
Command:
Output:
Each file contains:
Topic title
Timestamp
Source count
Full scraped content from up to 5 sources
Source URLs
Common Patterns
Pattern 1: Quick Research
Extract topics from existing notes, research them, save to current folder:
Pattern 2: Organized Research
Create dedicated output folder for research results:
Pattern 3: Deep Dive
Increase results per topic for comprehensive coverage:
Pattern 4: Obsidian Vault Integration
Direct output to vault's research folder:
Error Handling
"API key not found"
Create .env file in skill folder with FIRECRAWL API KEY=...
"Rate limit exceeded"
Free tier: 5 req/min
Script has 12s delay built in
If still hitting limit, reduce topics or wait between runs
"Insufficient credits"
Check FireCrawl account credits
Upgrade plan or wait for credit reset
"No topics found"
Add topics to markdown using:
Header format
[research] Topic format
[search] Topic format
Script Details
Location: scripts/firecrawl research.py
Dependencies:
python dotenv Environment variable management
requests HTTP requests to FireCrawl API
Install dependencies:
FireCrawl Features Used:
/v1/search endpoint Search with automatic scraping
scrapeOptions.formats: ['markdown'] Markdown output
scrapeOptions.onlyMainContent: true Filter noise
Academic Writing Templates
This skill includes templates for writing scientific papers in markdown format.
Available Templates
1. Pandoc Scholarly Paper ( assets/templates/pandoc scholarly paper.md )
Standard academic paper format
Compatible with Pandoc converter
Supports citations via BibTeX
Exports to PDF, DOCX, HTML
2. MyST Scientific Paper ( assets/templates/myst scientific paper.md )
MyST (Markedly Structured Text) format
Advanced cross referencing
Professional scientific publishing
Multi format export (PDF, LaTeX, DOCX)
Using Templates
Copy template to your project:
Edit content:
Update YAML frontmatter (title, authors, affiliations)
Write your content in sections
Add citations using [@AuthorYear] (Pandoc) or {cite}\ AuthorYear\ (MyST)
Convert to PDF/DOCX:
Bibliography Generation
Convert FireCrawl research results into BibTeX bibliography entries:
What it does:
Extracts URLs and titles from FireCrawl markdown files
Generates BibTeX @misc entries
Creates citation keys automatically
Adds access dates
Example workflow:
Citation Examples
Pandoc syntax:
MyST syntax:
Example Bibliography File
An example bibliography is provided in assets/references.bib with common entry types:
Journal articles ( @article )
Conference papers ( @inproceedings )
Books ( @book )
PhD theses ( @phdthesis )
Web resources ( @misc )
Preprints ( @article with arXiv)
Tips
1. Organize topics hierarchically Use for main topics, for subtopics
2. Use descriptive names Topic text becomes filename, make it clear
3. Batch processing Group related topics in one file for efficiency
4. Output organization Create separate folders for different research projects
5. Content review Results are truncated at 3000 chars/source for readability
6. Academic workflow Use bibliography generator to cite research sources in papers
7. Template customization Modify templates for your field's citation style
Limitations
No summarization Returns raw scraped content, not summaries
No deduplication Duplicate sources may appear across topics
No quality ranking All results treated equally
New files only Does not append to existing files
Free tier constraints Rate limiting affects processing speed