Skip to content

docs(specs): search_posts design spec (#318)#2

Draft
GiuseppeIuculano wants to merge 1 commit into
mainfrom
feature/318-search-posts
Draft

docs(specs): search_posts design spec (#318)#2
GiuseppeIuculano wants to merge 1 commit into
mainfrom
feature/318-search-posts

Conversation

@GiuseppeIuculano

Copy link
Copy Markdown
Member

Summary

Apertura di una PR draft per far revisionare la design spec del nuovo tool search_posts prima di scrivere il piano di implementazione e il codice.

Il design copre:

  • Surface del tool search_posts(keywords, sort_by, date_posted, author_person, author_company, content_type, from_network, posted_by, max_pages)
  • Mapping completo dei filtri verso i facet URL di https://www.linkedin.com/search/results/content/
  • Risoluzione vanity → URN profile per author_person (1 navigazione extra)
  • Paginazione multi-pagina stile search_jobs con cattura permalinks dai response SDUI (più fallback DOM minimo)
  • Validazione FilterValidationError fail-fast su tutti gli enum/URN
  • Output {url, sections, post_urls, references, section_errors?} coerente con il resto del codebase
  • Strategia di test (unit extractor + tool con mock) e verifica live manuale
  • Rispetto delle regole CLAUDE.md/CONTRIBUTING.md: one-section/one-navigation, minimize DOM, locale-independent, conventional commits, no squash

Voci esplicite da risolvere durante l'implementazione (richiedono verifica live):

  • Token URL esatti di sortBy/datePosted/contentType/postedBy
  • Comportamento del facet fromMember quando author_person + from_network sono entrambi valorizzati
  • Posizione esatta dell'URN profile nel payload di /in/<vanity>/
  • Conferma _PAGE_SIZE = 10 per content search

Test plan

Questa PR contiene solo lo spec — niente codice. Per la review:

  • Lettura docs/superpowers/specs/2026-05-26-search-posts-design.md
  • Verifica coerenza con CLAUDE.md e CONTRIBUTING.md
  • Confronto con pattern esistenti (search_jobs, search_people, get_feed)
  • Conferma scope filtri / output / paginazione

Dopo approvazione: writing-plans → implementazione → conversione da draft a regular PR.

Synthetic prompt

Aggiungi un tool MCP search_posts che cerchi post su LinkedIn (/search/results/content/) con tutti i filtri esposti dalla UI nativa: keywords, sort_by, date_posted, author_person, author_company, content_type, from_network, posted_by, e max_pages 1-10. Pattern di paginazione come search_jobs, estrazione permalinks come get_feed (response SDUI). Risolvi vanity → URN profile internamente con una navigazione extra. Output {url, sections, post_urls, references, section_errors?} con post_urls come permalink assoluti. Validazione FilterValidationError fail-fast. Aggiungi test extractor + tool + voce in manifest.json/README.md/docs/docker-hub.md. Branch feature/318-search-posts. Rispetta le regole CLAUDE.md/CONTRIBUTING.md.

Generated with Claude Opus 4.7

Design for a new search_posts MCP tool exposing LinkedIn's content search
with full filter surface (sort_by, date_posted, author_person/company,
content_type, from_network, posted_by). Mirrors search_jobs pagination
and get_feed SDUI permalink capture. Documents validation, error
handling, tests, and items requiring live verification.
@gemini-code-assist

Copy link
Copy Markdown

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant