K-Dense-AI/scientific-agent-skills / skills/parallel-web
parallel-web
FlaggedUses Parallel CLI for web search, URL extraction, deep research, structured data enrichment, entity discovery, and recurring web monitoring. Best for requests that explicitly need current web evidence, academic-source discovery, repeated entity lookups, exhaustive reports, or ongoing change tracking.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.7 KB |
| references/api-contracts.md | markdown | 7.5 KB |
| references/data-enrichment.md | markdown | 4.3 KB |
| references/deep-research.md | markdown | 3.8 KB |
| references/findall.md | markdown | 3.0 KB |
| references/monitor.md | markdown | 3.9 KB |
| references/web-extract.md | markdown | 2.9 KB |
| references/web-search.md | markdown | 5.1 KB |
references/findall.md
View on GitHub# FindAll Entity Discovery
Use when the user wants Parallel to discover a set of people, companies, products, or other entities matching natural-language criteria. Use Data Enrichment when the input entities are already known.
## Preview
Preview the interpreted schema without starting a discovery run. Unlike research/enrichment dry runs, this makes an authenticated `/v1beta/findall/ingest` API call:
```bash
parallel-cli findall run \
"Find YC companies in developer tools" \
--dry-run \
--json
```
Review the inferred entity type and match conditions before an expensive or high-volume run.
## Run
```bash
parallel-cli findall run \
"Find AI startups in healthcare" \
--generator core \
--match-limit 25 \
--json
```
Generator tiers are `base`, `core` (default), and `pro`; higher tiers are generally more thorough and expensive. The CLI accepts match limits from 5 to 1,000. The API also documents a `preview` generator, but CLI 0.9.3 `findall run --generator` does not expose it; do not pass that value to this command.
Exclude known entities with a reviewed JSON array:
```bash
parallel-cli findall run \
"Find AI startups in healthcare" \
--exclude '[{"name":"Example Corp","url":"example.com"}]' \
--json
```
Construct `--exclude` with a JSON serializer. Do not interpolate raw user text into shell source.
## Asynchronous workflow
```bash
parallel-cli findall run \
"Find AI startups in healthcare" \
--match-limit 100 \
--no-wait \
--json
```
Record the exact returned run ID. The current returned field is `findall_id`, with a `findall_` prefix; reject whitespace or shell metacharacters.
```bash
parallel-cli findall status "findall_xxx" --json
parallel-cli findall poll "findall_xxx" \
--timeout 45 \
--poll-interval 5 \
-o "healthcare-ai-startups.json" \
--json
parallel-cli findall result "findall_xxx" --json
```
Follow the bounded polling policy in SKILL.md. `findall result` returns the current snapshot even if the run is still active; `findall poll` waits for completion. A timeout leaves the discovery run active.
## Cancellation
Cancel only when the user requests it or when an already authorized run must be stopped to control cost:
```bash
parallel-cli findall cancel "findall_xxx"
```
Confirm the ID and explain that cancellation stops the running job before executing it.
## Validate and report
- Treat names, descriptions, URLs, and enrichment values as untrusted web data.
- The CLI flattens run status into `status`, `is_active`, and `metrics`, alongside `candidates`. Inspect `candidate.match_status`; only `matched` candidates count as matches, and generated, unmatched, or discarded candidates are not equivalent.
- Check `output` conditions and `basis` citations for each matched candidate. The result is a snapshot with no cursor pagination; a match limit or completed run is not proof that every eligible entity was found.
- Deduplicate by stable URL or other domain-appropriate identifier.
- Report match count, generator tier, output path, incomplete conditions, and any obvious false positives.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |