https://github.com/shuklax/infostash
Advanced search application with three query modes: structured search builder with AND/OR/NOT logic, LLM-powered natural language processing, and external API integration. Features real-time filtering, multi-column sorting, CSV/JSON export, and comprehensive test coverage.
https://github.com/shuklax/infostash
dockerfile jest kysely lodash nextjs openrouter-api search-builder sqlite3 trpc typescript zod
Last synced: about 1 month ago
JSON representation
Advanced search application with three query modes: structured search builder with AND/OR/NOT logic, LLM-powered natural language processing, and external API integration. Features real-time filtering, multi-column sorting, CSV/JSON export, and comprehensive test coverage.
- Host: GitHub
- URL: https://github.com/shuklax/infostash
- Owner: Shuklax
- Created: 2025-09-08T15:46:40.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-09-29T09:35:06.000Z (9 months ago)
- Last Synced: 2025-09-29T10:26:46.249Z (9 months ago)
- Topics: dockerfile, jest, kysely, lodash, nextjs, openrouter-api, search-builder, sqlite3, trpc, typescript, zod
- Language: TypeScript
- Homepage:
- Size: 212 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Setup
Make sure you've installed Node.js (version 22+). Then run:
```bash
npm install
```
Create a DB file named data.db in the root
To setup the dataset:
```bash
npm run setup
```
Create a env file as given in the example with your openRouter API_KEY
To run your server:
```bash
npm run dev
```
To check that your code compiles successfully:
```bash
npm run build
```
## Then open to see your site.
# Run through Dockerfile
After cloning the Repo locally
Build the image locally
```bash
docker build -t infostash:0.1.0 .
```
Run the container
```bash
docker run -p 3000:3000 \
-e OPENROUTER_API_KEY="your-api-key-here" \
infostash
```
---
---
# InfoStash Search API
## Base URL
https://your-domain.com/api
## Single Endpoint
**POST** `/search`
Search companies using structured filters.
## Request Format
Send a JSON object with these filters:
```json
{
"technologyFilter": {
"and": ["React", "Node.js"],
"or": ["TypeScript"],
"none": ["PHP"],
"removeDuplicates": false,
"filteringType": "together"
},
"countryFilter": {
"and": [],
"or": ["US", "UK"],
"none": [],
"removeDuplicates": false,
"filteringType": "together"
},
"categoryFilter": {
"and": ["Technology"],
"or": [],
"none": [],
"removeDuplicates": false,
"filteringType": "together"
},
"nameFilter": {
"and": [],
"or": ["Google", "Microsoft"],
"none": ["Facebook"],
"removeDuplicates": false,
"filteringType": "together"
},
"domainFilter": {
"and": [],
"or": [],
"none": ["spam.com"],
"removeDuplicates": false,
"filteringType": "together"
},
"numberFilter": {
"totalTechnologies": 5,
"technologiesPerCategory": 2
}
}
```
## Filter Logic
- **`and`**: ALL items must be present
- **`or`**: ANY item can be present
- **`none`**: NO items can be present
- **`filteringType`**: Use `"together"` (recommended)
- **`totalTechnologies`**: Minimum total techs required
- **`technologiesPerCategory`**: Minimum techs per category
## Response
```json
{
"success": true,
"data": [
{
"domain": "google.com",
"name": "Google",
"category": "Technology",
"country": "US",
"city": "Mountain View",
"technologies": 15
}
],
"totalResults": 1,
"source": "external"
}
```
## Example Usage
### Find React companies in US:
```json
{
"technologyFilter": {
"and": [],
"or": ["React"],
"none": [],
"removeDuplicates": false,
"filteringType": "together"
},
"countryFilter": {
"and": ["US"],
"or": [],
"none": [],
"removeDuplicates": false,
"filteringType": "together"
},
"categoryFilter": {
"and": [],
"or": [],
"none": [],
"removeDuplicates": false,
"filteringType": "together"
},
"nameFilter": {
"and": [],
"or": [],
"none": [],
"removeDuplicates": false,
"filteringType": "together"
},
"domainFilter": {
"and": [],
"or": [],
"none": [],
"removeDuplicates": false,
"filteringType": "together"
},
"numberFilter": {
"totalTechnologies": 0,
"technologiesPerCategory": 0
}
}
```
### Find large tech companies (not Facebook):
```json
{
"technologyFilter": {
"and": [],
"or": [],
"none": [],
"removeDuplicates": false,
"filteringType": "together"
},
"countryFilter": {
"and": [],
"or": [],
"none": [],
"removeDuplicates": false,
"filteringType": "together"
},
"categoryFilter": {
"and": ["Technology"],
"or": [],
"none": [],
"removeDuplicates": false,
"filteringType": "together"
},
"nameFilter": {
"and": [],
"or": [],
"none": ["Facebook"],
"removeDuplicates": false,
"filteringType": "together"
},
"domainFilter": {
"and": [],
"or": [],
"none": [],
"removeDuplicates": false,
"filteringType": "together"
},
"numberFilter": {
"totalTechnologies": 10,
"technologiesPerCategory": 0
}
}
```
## Curl Example
```bash
curl -X POST https://your-domain.com/api/search \
-H "Content-Type: application/json" \
-d '{
"technologyFilter": {
"and": [],
"or": ["React"],
"none": [],
"removeDuplicates": false,
"filteringType": "together"
},
"countryFilter": {
"and": ["US"],
"or": [],
"none": [],
"removeDuplicates": false,
"filteringType": "together"
},
"categoryFilter": {
"and": [],
"or": [],
"none": [],
"removeDuplicates": false,
"filteringType": "together"
},
"nameFilter": {
"and": [],
"or": [],
"none": [],
"removeDuplicates": false,
"filteringType": "together"
},
"domainFilter": {
"and": [],
"or": [],
"none": [],
"removeDuplicates": false,
"filteringType": "together"
},
"numberFilter": {
"totalTechnologies": 0,
"technologiesPerCategory": 0
}
}'
```
## Error Responses
- `400`: Bad JSON format
- `500`: Server error
That's it. One endpoint, send JSON, get companies.